@xano/developer-mcp 1.0.2 → 1.0.4

package/package.json

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

package/xanoscript_docs/apis.md

@@ -10,6 +10,7 @@ HTTP endpoint definitions in XanoScript.
 
 ```xs
 query "<path>" verb=<METHOD> {
+  api_group = "<GroupName>"     # Required: API group for organization
   description = "What this endpoint does"
   auth = "<table>"              # Optional: require authentication
   input { ... }
@@ -21,23 +22,65 @@ query "<path>" verb=<METHOD> {
 ### HTTP Methods
 `GET`, `POST`, `PUT`, `PATCH`, `DELETE`
 
+### API Groups (Required)
+
+Every API endpoint **must** belong to an API group. API groups organize related endpoints together.
+
+**Two requirements for API groups:**
+1. Each `query` definition **must** include an `api_group` property specifying which group it belongs to
+2. API groups are organized as folders within `apis/`, each with an `api_group.xs` file
+
+- API groups appear as top-level folders under `apis/`
+- Each group **must** have an `api_group.xs` file that defines the group
+- The group contains `.xs` files defining individual endpoints
+- The group name becomes part of the endpoint URL path
+- You cannot create endpoints directly in the `apis/` root folder
+
+#### Defining an API Group
+
+Create an `api_group.xs` file in the group folder:
+
+```xs
+api_group "users" {
+  description = "User management endpoints"
+}
+```
+
+#### API Group Properties
+
+| Property | Description |
+|----------|-------------|
+| `description` | What this API group contains |
+| `canonical` | Optional: custom URL path (overrides folder name) |
+
+```xs
+api_group "events" {
+  canonical = "events-api"           # URL will use /events-api instead of /events
+}
+```
+
 ### File Structure
 ```
 apis/
-├── users/                      # API group
+├── users/                      # API group folder
+│   ├── api_group.xs            # Required: defines the group
 │   ├── list.xs                 # GET /users
 │   ├── create.xs               # POST /users
 │   └── {id}.xs                 # GET/PATCH/DELETE /users/{id}
-└── products/
-    └── search.xs
+└── products/                   # Another API group
+    ├── api_group.xs            # Required: defines the group
+    └── search.xs               # GET /products/search
 ```
 
+> **Note:** Files placed directly in `apis/` without a group folder are invalid. Each API group folder must contain an `api_group.xs` file.
+
 ---
 
 ## Basic Structure
 
 ```xs
 query "products" verb=GET {
+  api_group = "Products"
   description = "List all products"
   input {
     int page?=1 filters=min:1
@@ -59,6 +102,7 @@ query "products" verb=GET {
 ### Public Endpoint (default)
 ```xs
 query "status" verb=GET {
+  api_group = "System"
   stack { }
   response = { status: "ok" }
 }
@@ -67,6 +111,7 @@ query "status" verb=GET {
 ### Authenticated Endpoint
 ```xs
 query "profile" verb=GET {
+  api_group = "Users"
   auth = "user"                 # Requires valid JWT
   stack {
     db.get "user" {
@@ -91,6 +136,7 @@ Use `{param}` in the path:
 
 ```xs
 query "users/{user_id}" verb=GET {
+  api_group = "Users"
   auth = "user"
   input {
     int user_id { table = "user" }
@@ -112,6 +158,7 @@ query "users/{user_id}" verb=GET {
 ### List (GET)
 ```xs
 query "products" verb=GET {
+  api_group = "Products"
   input {
     text category? filters=trim|lower
     int page?=1
@@ -131,6 +178,7 @@ query "products" verb=GET {
 ### Create (POST)
 ```xs
 query "products" verb=POST {
+  api_group = "Products"
   auth = "user"
   input {
     text name filters=trim
@@ -156,6 +204,7 @@ query "products" verb=POST {
 ### Read (GET with ID)
 ```xs
 query "products/{product_id}" verb=GET {
+  api_group = "Products"
   input {
     int product_id { table = "product" }
   }
@@ -177,6 +226,7 @@ query "products/{product_id}" verb=GET {
 ### Update (PATCH)
 ```xs
 query "products/{product_id}" verb=PATCH {
+  api_group = "Products"
   auth = "user"
   input {
     int product_id { table = "product" }
@@ -211,6 +261,7 @@ query "products/{product_id}" verb=PATCH {
 ### Delete (DELETE)
 ```xs
 query "products/{product_id}" verb=DELETE {
+  api_group = "Products"
   auth = "user"
   input {
     int product_id { table = "product" }