@xano/developer-mcp 1.0.6 → 1.0.8

package/README.md

@@ -39,6 +39,18 @@ Add to your Claude Desktop configuration file:
 }
 ```
 
+## Checking Your Version
+
+```bash
+npx @xano/developer-mcp --version
+```
+
+If installed from source:
+
+```bash
+node dist/index.js --version
+```
+
 ## Installation from Source
 
 ### Prerequisites

package/dist/index.js

@@ -11,6 +11,12 @@ import { getSchemeFromContent } from "@xano/xanoscript-language-server/utils.js"
 import { generateInitWorkspaceTemplate } from "./templates/init-workspace.js";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
+const pkg = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf-8"));
+const SERVER_VERSION = pkg.version;
+if (process.argv.includes("--version") || process.argv.includes("-v")) {
+    console.log(SERVER_VERSION);
+    process.exit(0);
+}
 const XANOSCRIPT_DOCS_V2 = {
     readme: {
         file: "README.md",
@@ -357,7 +363,7 @@ function generateInitWorkspaceDoc() {
 // =============================================================================
 const server = new Server({
     name: "xano-developer-mcp",
-    version: "1.0.0",
+    version: SERVER_VERSION,
     description: "MCP server for Xano Headless API documentation and XanoScript code validation",
 }, {
     capabilities: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xano/developer-mcp",
-  "version": "1.0.6",
+  "version": "1.0.8",
   "description": "MCP server for Xano Headless API documentation and XanoScript code validation",
   "type": "module",
   "main": "dist/index.js",

package/xanoscript_docs/README.md

@@ -16,22 +16,24 @@ XanoScript is the declarative scripting language for [Xano](https://xano.com), a
 | `mcp_server` | `mcp_servers/**/*.xs` | MCP server definitions |
 | `addon` | `addons/*.xs` | Subqueries for related data |
 
+**Important:** Each `.xs` file must contain exactly one definition. You cannot define multiple tables, functions, queries, or other constructs in a single file.
+
 ## Workspace Structure
 
 ```
 project/
-├── tables/              # Database table schemas
-├── functions/           # Reusable functions (supports subfolders)
+├── tables/              // Database table schemas
+├── functions/           // Reusable functions (supports subfolders)
 ├── apis/
-│   └── <api-group>/     # API endpoints grouped by domain
-├── tasks/               # Scheduled jobs
-├── triggers/            # Event-driven handlers
-├── agents/              # AI agents
-├── tools/               # AI tools
-├── mcp_servers/         # MCP server definitions
-├── addons/              # Query addons
-├── static/              # Frontend files (HTML, CSS, JS)
-└── ephemeral/           # Temporary test environments
+│   └── <api-group>/     // API endpoints grouped by domain
+├── tasks/               // Scheduled jobs
+├── triggers/            // Event-driven handlers
+├── agents/              // AI agents
+├── tools/               // AI tools
+├── mcp_servers/         // MCP server definitions
+├── addons/              // Query addons
+├── static/              // Frontend files (HTML, CSS, JS)
+└── ephemeral/           // Temporary test environments
 ```
 
 ## Environment Variables
@@ -55,28 +57,36 @@ Custom environment variables are set in the Xano dashboard and accessed as `$env
 ### Block Structure
 ```xs
 <construct> "<name>" {
-  input { ... }      # Parameters (optional)
-  stack { ... }      # Logic
-  response = $var    # Output
+  input { ... }      // Parameters (optional)
+  stack { ... }      // Logic
+  response = $var    // Output
 }
 ```
 
 ### Variable Access
 ```xs
-$input.field        # Input parameters
-$var.field          # Stack variables
-$auth.id            # Authenticated user ID
-$env.MY_VAR         # Environment variable
-$db.table.field     # Database field reference (in queries)
-$this               # Current item in loops/maps
+$input.field        // Input parameters
+$var.field          // Stack variables
+$auth.id            // Authenticated user ID
+$env.MY_VAR         // Environment variable
+$db.table.field     // Database field reference (in queries)
+$this               // Current item in loops/maps
 ```
 
+### Comments
+```xs
+// Single-line comment
+var $total { value = 0 }  // Inline comment
+```
+
+**Note:** XanoScript only supports `//` for comments. Other comment styles like `#` are not supported.
+
 ### Filters (Pipe Syntax)
 ```xs
-$value|trim|lower                    # Chain filters
-$input.name|strlen                   # Get length
-$array|first                         # First element
-($a + $b)|round:2                    # Math with precision
+$value|trim|lower                    // Chain filters
+$input.name|strlen                   // Get length
+$array|first                         // First element
+($a + $b)|round:2                    // Math with precision
 ```
 
 ## File Frontmatter

package/xanoscript_docs/agents.md

@@ -71,10 +71,10 @@ ai.agent.run "Customer Support" {
 
 ```xs
 llm = {
-  type: "<provider>"                    # Required
-  system_prompt: "..."                  # Agent persona and rules
-  prompt: "{{ $args.input }}"           # User input template
-  max_steps: 5                          # Max LLM calls per run
+  type: "<provider>"                    // Required
+  system_prompt: "..."                  // Agent persona and rules
+  prompt: "{{ $args.input }}"           // User input template
+  max_steps: 5                          // Max LLM calls per run
 }
 ```
 
@@ -94,7 +94,7 @@ llm = {
   prompt: "{{ $args.message }}"
   max_steps: 3
   temperature: 0
-  search_grounding: false               # Google Search grounding
+  search_grounding: false               // Google Search grounding
 }
 ```
 
@@ -108,7 +108,7 @@ llm = {
   prompt: "{{ $args.message }}"
   max_steps: 5
   temperature: 0.2
-  thinking_tokens: 10000                # Extended thinking
+  thinking_tokens: 10000                // Extended thinking
   include_thoughts: true
 }
 ```
@@ -123,7 +123,7 @@ llm = {
   prompt: "{{ $args.message }}"
   max_steps: 5
   temperature: 0.8
-  reasoning_effort: "medium"            # low, medium, high
+  reasoning_effort: "medium"            // low, medium, high
 }
 ```
 
@@ -134,7 +134,7 @@ llm = {
   api_key: "{{ $env.GROQ_API_KEY }}"
   baseURL: "https://api.groq.com/openai/v1"
   model: "llama-3.3-70b-versatile"
-  compatibility: "compatible"           # Required for non-OpenAI
+  compatibility: "compatible"           // Required for non-OpenAI
   ...
 }
 ```
@@ -151,7 +151,7 @@ llm = {
   prompt: "{{ $args.message }}"
   max_steps: 8
   temperature: 0.3
-  send_reasoning: true                  # Include thinking blocks
+  send_reasoning: true                  // Include thinking blocks
 }
 ```
 
@@ -218,9 +218,9 @@ llm = {
 
 ### Available Variables
 ```xs
-{{ $args.any_arg }}                     # Runtime arguments
-{{ $env.MY_VAR }}                       # Environment variables
-{{ "now"|date("Y-m-d") }}               # Current date
+{{ $args.any_arg }}                     // Runtime arguments
+{{ $env.MY_VAR }}                       // Environment variables
+{{ "now"|date("Y-m-d") }}               // Current date
 ```
 
 ---

package/xanoscript_docs/apis.md

@@ -9,19 +9,19 @@ HTTP endpoint definitions in XanoScript.
 ## Quick Reference
 
 ```xs
-query "<name>" verb=<METHOD> {
-  api_group = "<GroupName>"     # Required: API group for organization
+query "endpoint-path" verb=<METHOD> {
+  api_group = "<GroupName>"     // Required: API group for organization
   description = "What this endpoint does"
-  auth = "<table>"              # Optional: require authentication
+  auth = "<table>"              // Optional: require authentication
   input { ... }
   stack { ... }
   response = $result
 }
 ```
 
-### Query Name (Required)
+### Query Name (Required, Non-Empty)
 
-The query name is **required** and cannot be empty. It defines the endpoint path after the API group canonical.
+The query name is **required** and **must be a non-empty string**. Empty names (`query "" verb=...`) are invalid. The name defines the endpoint path after the API group canonical.
 
 **Full URL path structure:**
 ```
@@ -42,8 +42,8 @@ Every endpoint must belong to an API group. Each group is a folder with an `api_
 
 ```xs
 api_group "users" {
-  canonical = "users"                # Required: URL path segment
-  description = "User management"    # Optional
+  canonical = "users"                // Required: URL path segment
+  description = "User management"    // Optional
 }
 ```
 
@@ -51,12 +51,12 @@ api_group "users" {
 ```
 apis/
 ├── users/
-│   ├── api_group.xs            # Defines group (canonical = "users")
-│   ├── list.xs                 # GET /users/list
-│   └── by-id.xs                # GET/PATCH/DELETE /users/{id}
+│   ├── api_group.xs            // Defines group (canonical = "users")
+│   ├── list.xs                 // GET /users/list
+│   └── by-id.xs                // GET/PATCH/DELETE /users/{id}
 └── products/
-    ├── api_group.xs            # Defines group (canonical = "products")
-    └── search.xs               # GET /products/search
+    ├── api_group.xs            // Defines group (canonical = "products")
+    └── search.xs               // GET /products/search
 ```
 
 Full URL: `/<canonical>/<query name>` (e.g., `/users/profile`)
@@ -99,11 +99,11 @@ query "status" verb=GET {
 ```xs
 query "profile" verb=GET {
   api_group = "Users"
-  auth = "user"                 # Requires valid JWT
+  auth = "user"                 // Requires valid JWT
   stack {
     db.get "user" {
       field_name = "id"
-      field_value = $auth.id    # User ID from token
+      field_value = $auth.id    // User ID from token
     } as $user
   }
   response = $user

package/xanoscript_docs/database.md

@@ -35,7 +35,7 @@ db.query "product" {
 
 ### Where Operators
 ```xs
-# Comparison
+// Comparison
 $db.product.price == 100
 $db.product.price != 0
 $db.product.price > 50
@@ -43,32 +43,32 @@ $db.product.price >= 50
 $db.product.price < 100
 $db.product.price <= 100
 
-# Null-safe (ignore if value is null)
+// Null-safe (ignore if value is null)
 $db.product.category ==? $input.category
 $db.product.price >=? $input.min_price
 
-# String matching
-$db.product.name includes "phone"       # Contains substring
-$db.product.tags contains "featured"    # Array contains value
+// String matching
+$db.product.name includes "phone"       // Contains substring
+$db.product.tags contains "featured"    // Array contains value
 $db.product.tags not contains "hidden"
 
-# Array overlap
+// Array overlap
 $db.product.tags overlaps ["a", "b"]
 $db.product.tags not overlaps ["x", "y"]
 
-# Combining conditions
+// Combining conditions
 $db.product.is_active == true && $db.product.price > 0
 $db.product.category == "electronics" || $db.product.featured == true
 ```
 
 ### Return Types
 ```xs
-# List (default)
+// List (default)
 db.query "product" {
   return = { type: "list" }
 } as $products
 
-# With pagination
+// With pagination
 db.query "product" {
   return = {
     type: "list",
@@ -76,19 +76,19 @@ db.query "product" {
   }
 } as $products
 
-# Single record
+// Single record
 db.query "product" {
   where = $db.product.sku == $input.sku
   return = { type: "single" }
 } as $product
 
-# Count
+// Count
 db.query "product" {
   where = $db.product.is_active == true
   return = { type: "count" }
 } as $count
 
-# Exists
+// Exists
 db.query "product" {
   where = $db.product.email == $input.email
   return = { type: "exists" }
@@ -98,9 +98,9 @@ db.query "product" {
 ### Sorting
 ```xs
 db.query "product" {
-  sort = { created_at: "desc" }         # Descending
-  sort = { name: "asc" }                # Ascending
-  sort = { id: "rand" }                 # Random
+  sort = { created_at: "desc" }         // Descending
+  sort = { name: "asc" }                // Ascending
+  sort = { id: "rand" }                 // Random
 } as $products
 ```
 
@@ -110,7 +110,7 @@ db.query "comment" {
   join = {
     post: {
       table: "post",
-      type: "inner",                    # inner, left, right
+      type: "inner",                    // inner, left, right
       where: $db.comment.post_id == $db.post.id
     }
   }
@@ -279,7 +279,7 @@ Delete all records from a table.
 
 ```xs
 db.truncate "temp_data" {
-  reset = true                          # Reset auto-increment
+  reset = true                          // Reset auto-increment
 }
 ```
 
@@ -293,7 +293,7 @@ Execute raw SQL (use sparingly).
 db.direct_query {
   sql = "SELECT * FROM users WHERE email = ? AND status = ?"
   arg = [$input.email, "active"]
-  response_type = "list"                # list or single
+  response_type = "list"                // list or single
 } as $results
 ```
 
@@ -339,9 +339,9 @@ Filters for use in `where` clauses:
 
 ### String/Text
 ```xs
-$db.name|to_lower                       # Case conversion
-$db.name|concat:" "                     # Concatenation
-$db.text|substr:0:100                   # Substring
+$db.name|to_lower                       // Case conversion
+$db.name|concat:" "                     // Concatenation
+$db.text|substr:0:100                   // Substring
 ```
 
 ### Numeric
@@ -363,8 +363,8 @@ $db.created_at|timestamp_subtract_hours:24
 
 ### Geographic
 ```xs
-$db.location|distance:$input.point      # Distance in meters
-$db.location|within:$input.point:1000   # Within radius
+$db.location|distance:$input.point      // Distance in meters
+$db.location|within:$input.point:1000   // Within radius
 ```
 
 ### Vector (AI/ML)
@@ -385,7 +385,7 @@ $db.content|search_rank:$input.query
 Connect to external databases:
 
 ```xs
-# PostgreSQL
+// PostgreSQL
 db.external.postgres.direct_query {
   connection_string = $env.EXTERNAL_PG_URL
   sql = "SELECT * FROM users WHERE id = ?"
@@ -393,13 +393,13 @@ db.external.postgres.direct_query {
   response_type = "single"
 } as $user
 
-# MySQL
+// MySQL
 db.external.mysql.direct_query { ... }
 
-# MS SQL
+// MS SQL
 db.external.mssql.direct_query { ... }
 
-# Oracle
+// Oracle
 db.external.oracle.direct_query { ... }
 ```
 

package/xanoscript_docs/ephemeral.md

@@ -116,8 +116,8 @@ One-time operation with setup and cleanup hooks.
 ```xs
 function "$main" {
   input {
-    json args                   # Runtime arguments
-    json pre                    # Result from $pre
+    json args                   // Runtime arguments
+    json pre                    // Result from $pre
   }
   stack {
     db.query authors {

package/xanoscript_docs/frontend.md

@@ -11,10 +11,10 @@ Static frontend development and Lovable/Supabase migration.
 ### Directory Structure
 ```
 static/
-├── index.html              # Main entry point
+├── index.html              // Main entry point
 ├── css/
 ├── js/
-│   └── api.js              # Centralized API calls
+│   └── api.js              // Centralized API calls
 └── assets/
 ```
 

package/xanoscript_docs/functions.md

@@ -15,7 +15,7 @@ function "<name>" {
     <type> <name> [filters=...] { description = "..." }
   }
   stack {
-    # Logic here
+    // Logic here
   }
   response = $result
 }
@@ -110,21 +110,21 @@ stack {
 ### Loops
 ```xs
 stack {
-  # For loop (count-based)
+  // For loop (count-based)
   for (10) {
     each as $i {
       debug.log { value = $i }
     }
   }
 
-  # Foreach (array iteration)
+  // Foreach (array iteration)
   foreach ($input.items) {
     each as $item {
       debug.log { value = $item.name }
     }
   }
 
-  # While loop
+  // While loop
   while ($counter < 5) {
     each {
       math.add $counter { value = 1 }
@@ -161,10 +161,10 @@ For complete error handling reference (preconditions, try-catch, throw, early re
 Specify what the function returns:
 
 ```xs
-response = $total                    # Single variable
-response = { success: true, data: $result }   # Object literal
-response = $items|first              # With filter
-response = null                      # No return value
+response = $total                    // Single variable
+response = { success: true, data: $result }   // Object literal
+response = $items|first              // With filter
+response = null                      // No return value
 ```
 
 ---

package/xanoscript_docs/integrations.md

@@ -182,20 +182,20 @@ cloud.elasticsearch.document {
 
 ### Key-Value Operations
 ```xs
-# Set value
+// Set value
 redis.set {
   key = "user:123:session"
   data = $session_data
-  ttl = 3600                            # Expires in 1 hour
+  ttl = 3600                            // Expires in 1 hour
 }
 
-# Get value
+// Get value
 redis.get { key = "user:123:session" } as $session
 
-# Check exists
+// Check exists
 redis.has { key = "user:123:session" } as $exists
 
-# Delete
+// Delete
 redis.del { key = "user:123:session" }
 ```
 

package/xanoscript_docs/mcp-servers.md

@@ -147,18 +147,18 @@ mcp_server "CRM" {
 ### By Domain
 ```
 mcp_servers/
-├── support.xs          # Customer support tools
-├── ecommerce.xs        # Store management
-├── analytics.xs        # Reporting and metrics
-└── admin.xs            # Administrative functions
+├── support.xs          // Customer support tools
+├── ecommerce.xs        // Store management
+├── analytics.xs        // Reporting and metrics
+└── admin.xs            // Administrative functions
 ```
 
 ### By Access Level
 ```
 mcp_servers/
-├── public.xs           # Public-facing tools
-├── authenticated.xs    # Requires auth
-└── admin.xs            # Admin-only tools
+├── public.xs           // Public-facing tools
+├── authenticated.xs    // Requires auth
+└── admin.xs            // Admin-only tools
 ```
 
 ---