@xano/developer-mcp 1.0.50 → 1.0.52

package/dist/tools/validate_xanoscript.js

@@ -42,6 +42,7 @@ const RESERVED_VARIABLES = [
     "$response",
     "$output",
     "$input",
+    "$index",
     "$auth",
     "$env",
     "$db",

package/dist/xanoscript_docs/README.md

@@ -111,7 +111,7 @@ $db.table.field     // Database field reference (in queries)
 $this               // Current item in loops/maps
 ```
 
-**Reserved Variables:** The following cannot be used as variable names: `$response`, `$output`, `$input`, `$auth`, `$env`, `$db`, `$this`, `$result`.
+**Reserved Variables:** The following cannot be used as variable names: `$response`, `$output`, `$input`, `$auth`, `$env`, `$db`, `$this`, `$result`, `$index`.
 
 ### Type Names
 

package/dist/xanoscript_docs/cheatsheet.md

@@ -63,8 +63,8 @@ foreach ($input.items) {
 
 // For loop (iterate N times)
 for (10) {
-  each as $index {
-    debug.log { value = $index }
+  each as $idx {
+    debug.log { value = $idx }
   }
 }
 
@@ -249,7 +249,7 @@ var $msg { value = ($status|to_text) ~ ": " ~ ($data|json_encode) }
 
 ## Reserved Variables (Cannot Use)
 
-`$response`, `$output`, `$input`, `$auth`, `$env`, `$db`, `$this`, `$result`
+`$response`, `$output`, `$input`, `$auth`, `$env`, `$db`, `$this`, `$result`, `$index`
 
 ## Input Block Syntax
 

package/dist/xanoscript_docs/functions.md

@@ -143,14 +143,14 @@ stack {
   }
 
   // Foreach (array iteration) - no built-in index; count manually if needed
-  var $index {
+  var $idx {
     value = 0
   }
   foreach ($input.items) {
     each as $item {
       debug.log { value = $item.name }
-      debug.log { value = $index }
-      math.add $index { value = 1 }
+      debug.log { value = $idx }
+      math.add $idx { value = 1 }
     }
   }
 
@@ -445,21 +445,6 @@ foreach ($items) {
 }
 ```
 
-### Loop with Index
-
-```xs
-foreach ($items) {
-  each as $item, $index {
-    db.add "item" {
-      data = {
-        value: $item,
-        position: $index
-      }
-    }
-  }
-}
-```
-
 ---
 
 ## Naming Rules

package/dist/xanoscript_docs/quickstart.md

@@ -10,6 +10,36 @@ Essential patterns for XanoScript development. Use this as a quick reference for
 
 ## Quick Reference
 
+### Variable Access Rules
+
+**Inputs must use `$input.fieldname` — no shorthand exists.**
+
+Input fields declared in the `input {}` block are only accessible via the `$input` prefix. You cannot reference them as bare variables.
+
+```xs
+input {
+  text name
+  int age
+}
+
+// ❌ Wrong — $name is not defined; inputs live on $input
+var $greeting { value = "Hello, " ~ $name }
+
+// ✅ Correct
+var $greeting { value = "Hello, " ~ $input.name }
+var $is_adult { value = $input.age >= 18 }
+```
+
+**Stack variables have an optional `$var.` prefix — both forms are identical.**
+
+```xs
+var $total { value = 100 }
+
+// ✅ Both are the same thing
+$var.total       // explicit prefix form
+$total           // shorthand form (no prefix)
+```
+
 ### Reserved Variable Names
 
 These variable names are reserved and cannot be used:
@@ -24,6 +54,7 @@ These variable names are reserved and cannot be used:
 | `$db` | Database table reference for queries |
 | `$this` | Current context reference |
 | `$result` | Used in reduce operations |
+| `$index` | Reserved for some array operations |
 
 ```xs
 // ❌ Wrong - using reserved variable name

package/dist/xanoscript_docs/syntax.md

@@ -85,6 +85,29 @@ Working with...
 
 ## Quick Reference
 
+### Variable Access Prefixes
+
+| Prefix | Applies to | Shorthand? |
+|--------|-----------|------------|
+| `$input.field` | Input parameters | No — prefix always required |
+| `$var.field` | Stack variables | Yes — `$field` is identical |
+| `$auth.field` | Auth context | No |
+| `$env.NAME` | Environment variables | No |
+| `$db.table.field` | DB field refs (queries) | No |
+
+```xs
+// ❌ Wrong — input fields are NOT accessible as bare variables
+var $name { value = $name }      // undefined; inputs live on $input
+
+// ✅ Correct — always use $input for input fields
+var $name { value = $input.name }
+
+// ✅ Both are valid for stack variables
+var $total { value = 0 }
+$var.total      // explicit
+$total          // shorthand — same thing
+```
+
 ### Operators
 | Category | Operators |
 |----------|-----------|

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xano/developer-mcp",
-  "version": "1.0.50",
+  "version": "1.0.52",
   "description": "MCP server and library for Xano development - XanoScript validation, Meta API, Run API, and CLI documentation",
   "type": "module",
   "main": "dist/lib.js",