@xano/developer-mcp 1.0.13 → 1.0.15

package/dist/meta_api_docs/topics/realtime.js

@@ -0,0 +1,112 @@
+export const realtimeDoc = {
+    topic: "realtime",
+    title: "Realtime Channel Management",
+    description: `Realtime channels enable WebSocket-based push notifications and live updates to connected clients.
+
+## Key Concepts
+- Channels are WebSocket endpoints for real-time communication
+- Clients subscribe to channels to receive updates
+- Server can publish messages to channels
+- Triggers can respond to channel events
+- Useful for chat, notifications, live updates
+
+## Common Use Cases
+- Live chat applications
+- Real-time notifications
+- Live dashboards
+- Collaborative editing
+- Push updates to mobile apps`,
+    ai_hints: `- Create channels for different message types (chat, notifications, etc.)
+- Use triggers to respond to channel events (subscribe, message, etc.)
+- Channels require authenticated connections for security
+- Consider rate limiting for high-traffic channels
+- Test with WebSocket clients before production`,
+    endpoints: [
+        {
+            method: "GET",
+            path: "/workspace/{workspace_id}/realtime/channel",
+            tool_name: "listRealtimeChannels",
+            description: "List all realtime channels in a workspace.",
+            parameters: [
+                { name: "workspace_id", type: "integer", required: true, in: "path", description: "Workspace ID" },
+                { name: "page", type: "integer", default: 1, description: "Page number" },
+                { name: "per_page", type: "integer", default: 50, description: "Items per page" },
+                { name: "search", type: "string", description: "Search by channel name" }
+            ]
+        },
+        {
+            method: "GET",
+            path: "/workspace/{workspace_id}/realtime/channel/{channel_id}",
+            tool_name: "getRealtimeChannel",
+            description: "Get details of a specific realtime channel.",
+            parameters: [
+                { name: "workspace_id", type: "integer", required: true, in: "path", description: "Workspace ID" },
+                { name: "channel_id", type: "integer", required: true, in: "path", description: "Channel ID" }
+            ]
+        },
+        {
+            method: "POST",
+            path: "/workspace/{workspace_id}/realtime/channel",
+            tool_name: "createRealtimeChannel",
+            description: "Create a new realtime channel.",
+            parameters: [
+                { name: "workspace_id", type: "integer", required: true, in: "path", description: "Workspace ID" }
+            ],
+            request_body: {
+                type: "application/json",
+                properties: {
+                    name: { type: "string", description: "Channel name", required: true },
+                    description: { type: "string", description: "Channel description" }
+                }
+            },
+            example: {
+                method: "POST",
+                path: "/workspace/1/realtime/channel",
+                body: {
+                    name: "notifications",
+                    description: "User notification channel"
+                }
+            }
+        },
+        {
+            method: "PUT",
+            path: "/workspace/{workspace_id}/realtime/channel/{channel_id}",
+            tool_name: "updateRealtimeChannel",
+            description: "Update an existing realtime channel.",
+            parameters: [
+                { name: "workspace_id", type: "integer", required: true, in: "path", description: "Workspace ID" },
+                { name: "channel_id", type: "integer", required: true, in: "path", description: "Channel ID" }
+            ],
+            request_body: {
+                type: "application/json",
+                properties: {
+                    name: { type: "string", description: "Channel name" },
+                    description: { type: "string", description: "Channel description" }
+                }
+            }
+        },
+        {
+            method: "DELETE",
+            path: "/workspace/{workspace_id}/realtime/channel/{channel_id}",
+            tool_name: "deleteRealtimeChannel",
+            description: "Delete a realtime channel.",
+            parameters: [
+                { name: "workspace_id", type: "integer", required: true, in: "path", description: "Workspace ID" },
+                { name: "channel_id", type: "integer", required: true, in: "path", description: "Channel ID" }
+            ]
+        }
+    ],
+    schemas: {
+        RealtimeChannel: {
+            type: "object",
+            properties: {
+                id: { type: "integer" },
+                name: { type: "string" },
+                description: { type: "string" },
+                created_at: { type: "string", format: "date-time" },
+                updated_at: { type: "string", format: "date-time" }
+            }
+        }
+    },
+    related_topics: ["api", "function"]
+};

package/dist/meta_api_docs/topics/start.d.ts

@@ -0,0 +1,2 @@
+import type { TopicDoc } from "../types.js";
+export declare const startDoc: TopicDoc;

package/dist/meta_api_docs/topics/start.js

@@ -0,0 +1,107 @@
+export const startDoc = {
+    topic: "start",
+    title: "Xano Meta API - Getting Started",
+    description: `The Xano Meta API provides programmatic access to manage your Xano instance. Use it to create, modify, and manage workspaces, databases, APIs, functions, scheduled tasks, AI agents, and more.
+
+## Base URL
+\`\`\`
+https://<your-instance-subdomain>.xano.io/api:meta/<endpoint>
+\`\`\`
+
+**Example:** If your Xano instance is \`https://x8ki-letl-twmt.n7.xano.io\`, the full URL to list workspaces would be:
+\`\`\`
+https://x8ki-letl-twmt.n7.xano.io/api:meta/workspace
+\`\`\`
+
+Your instance URL can be found in the Xano dashboard URL or in your API endpoint URLs.
+
+## Authentication
+Include your Access Token in the Authorization header:
+\`\`\`
+Authorization: Bearer <your-access-token>
+\`\`\`
+
+Access tokens are created in the Xano dashboard under Settings > Access Tokens.
+
+## Quick Start
+1. **Get your workspaces:** \`GET /workspace\`
+2. **List tables in a workspace:** \`GET /workspace/{id}/table\`
+3. **Create an API endpoint:** \`POST /workspace/{id}/apigroup/{id}/api\`
+
+## Resource Hierarchy
+\`\`\`
+workspace/
+  ├── apigroup/         # API groups (REST endpoint collections)
+  │   └── api/          # Individual endpoints
+  ├── table/            # Database tables
+  │   ├── schema/       # Table schema definitions
+  │   ├── index/        # Database indexes
+  │   └── trigger/      # Table triggers
+  ├── function/         # Reusable functions
+  ├── task/             # Scheduled tasks
+  ├── agent/            # AI agents
+  │   └── trigger/      # Agent triggers
+  ├── tool/             # Agent tools
+  ├── mcp_server/       # MCP servers
+  │   └── trigger/      # MCP triggers
+  ├── middleware/       # Request interceptors
+  ├── realtime/         # WebSocket channels
+  │   └── trigger/      # Realtime triggers
+  ├── branch/           # Environment branches
+  └── file/             # File storage
+\`\`\`
+
+## Common Parameters
+Most list endpoints support:
+- \`page\`: Page number (default: 1)
+- \`per_page\`: Items per page (default: 50, max: 10000)
+- \`search\`: Search by name
+- \`sort\`: Sort field (usually: id, name, created_at)
+- \`order\`: Sort direction (asc, desc)
+- \`branch\`: Filter by branch name
+
+## XanoScript Integration
+Many endpoints accept XanoScript code for logic definition:
+- Use \`include_xanoscript=true\` to get code in responses
+- POST/PUT bodies can include XanoScript directly
+- Use \`/convert/fromXS\` and \`/convert/toXS\` for format conversion`,
+    ai_hints: `- Start by calling \`GET /workspace\` to get workspace IDs
+- Use \`GET /workspace/{id}/context\` to get a full workspace map for AI understanding
+- Always check existing resources before creating new ones
+- Use \`include_xanoscript=true\` to see implementation details
+- Draft/publish workflow: changes are drafts until published`,
+    related_topics: ["authentication", "workspace", "workflows"],
+    examples: [
+        {
+            title: "List all workspaces",
+            description: "Get a list of all accessible workspaces",
+            request: {
+                method: "GET",
+                path: "/workspace",
+                headers: { "Authorization": "Bearer <token>" }
+            },
+            response: {
+                curPage: 1,
+                nextPage: null,
+                prevPage: null,
+                items: [
+                    { id: 1, name: "My App", description: "Production workspace" }
+                ]
+            }
+        },
+        {
+            title: "Get workspace context for AI",
+            description: "Generate complete workspace context for AI agents",
+            request: {
+                method: "GET",
+                path: "/workspace/1/context?format=json",
+                headers: { "Authorization": "Bearer <token>" }
+            },
+            response: {
+                tables: ["users", "posts", "comments"],
+                api_groups: [{ name: "public", endpoints: 12 }],
+                functions: ["auth_check", "send_email"]
+            }
+        }
+    ]
+};

package/dist/meta_api_docs/topics/table.d.ts

@@ -0,0 +1,2 @@
+import type { TopicDoc } from "../types.js";
+export declare const tableDoc: TopicDoc;

package/dist/meta_api_docs/topics/table.js

@@ -0,0 +1,195 @@
+export const tableDoc = {
+    topic: "table",
+    title: "Database Table Management",
+    description: `Tables are the database layer in Xano. Each table has a schema (fields), indexes, and optional triggers.
+
+## Key Concepts
+- Tables store structured data with typed fields
+- Schemas define field types, validation, and defaults
+- Indexes improve query performance
+- Triggers run automatically on data changes
+- Tables can reference other tables (foreign keys)
+
+## Field Types
+- **Primitives:** int, text, bool, decimal, email, password
+- **Temporal:** timestamp, date
+- **Structured:** json, object
+- **Files:** blob (with subtypes: image, video, audio, attachment)
+- **References:** tableref, tablerefuuid (foreign keys)
+- **Special:** enum, vector, geo_* (point, polygon, etc.)`,
+    ai_hints: `- Always check existing schema before adding fields
+- Use \`tableref\` type for foreign keys to other tables
+- Consider indexes for frequently queried fields
+- Triggers run automatically - be careful with side effects
+- Use \`include_xanoscript=true\` to see full table definition`,
+    endpoints: [
+        {
+            method: "GET",
+            path: "/workspace/{workspace_id}/table",
+            tool_name: "listTables",
+            description: "List all database tables in a workspace.",
+            parameters: [
+                { name: "workspace_id", type: "integer", required: true, in: "path", description: "Workspace ID" },
+                { name: "page", type: "integer", default: 1, description: "Page number" },
+                { name: "per_page", type: "integer", default: 50, description: "Items per page" },
+                { name: "search", type: "string", description: "Search by table name" },
+                { name: "sort", type: "string", enum: ["id", "name", "created_at"], default: "created_at", description: "Sort field" },
+                { name: "order", type: "string", enum: ["asc", "desc"], default: "desc", description: "Sort direction" },
+                { name: "include_xanoscript", type: "boolean", default: false, description: "Include XanoScript schema definition" },
+                { name: "branch", type: "string", description: "Filter by branch name" }
+            ]
+        },
+        {
+            method: "GET",
+            path: "/workspace/{workspace_id}/table/{table_id}",
+            tool_name: "getTable",
+            description: "Get details of a specific table including schema.",
+            parameters: [
+                { name: "workspace_id", type: "integer", required: true, in: "path", description: "Workspace ID" },
+                { name: "table_id", type: "integer", required: true, in: "path", description: "Table ID" },
+                { name: "include_xanoscript", type: "boolean", default: false, description: "Include XanoScript definition" }
+            ]
+        },
+        {
+            method: "POST",
+            path: "/workspace/{workspace_id}/table",
+            tool_name: "createTable",
+            description: "Create a new database table with optional schema.",
+            parameters: [
+                { name: "workspace_id", type: "integer", required: true, in: "path", description: "Workspace ID" }
+            ],
+            request_body: {
+                type: "application/json",
+                properties: {
+                    name: { type: "string", description: "Table name", required: true },
+                    description: { type: "string", description: "Table description" },
+                    xanoscript: { type: "string", description: "XanoScript table definition with schema" }
+                }
+            },
+            example: {
+                method: "POST",
+                path: "/workspace/1/table",
+                body: {
+                    name: "users",
+                    xanoscript: `table users {
+  id int [pk, auto]
+  email text [unique]
+  name text
+  created_at timestamp [default:now]
+}`
+                }
+            }
+        },
+        {
+            method: "PUT",
+            path: "/workspace/{workspace_id}/table/{table_id}",
+            tool_name: "updateTable",
+            description: "Update table definition and schema.",
+            parameters: [
+                { name: "workspace_id", type: "integer", required: true, in: "path", description: "Workspace ID" },
+                { name: "table_id", type: "integer", required: true, in: "path", description: "Table ID" }
+            ],
+            request_body: {
+                type: "application/json",
+                properties: {
+                    name: { type: "string", description: "Table name" },
+                    description: { type: "string", description: "Table description" },
+                    xanoscript: { type: "string", description: "Updated XanoScript definition" }
+                }
+            }
+        },
+        {
+            method: "DELETE",
+            path: "/workspace/{workspace_id}/table/{table_id}",
+            tool_name: "deleteTable",
+            description: "Delete a table and all its data. This action is irreversible.",
+            parameters: [
+                { name: "workspace_id", type: "integer", required: true, in: "path", description: "Workspace ID" },
+                { name: "table_id", type: "integer", required: true, in: "path", description: "Table ID" }
+            ]
+        },
+        {
+            method: "POST",
+            path: "/workspace/{workspace_id}/table/{table_id}/schema",
+            tool_name: "addTableField",
+            description: "Add a new field to the table schema.",
+            parameters: [
+                { name: "workspace_id", type: "integer", required: true, in: "path", description: "Workspace ID" },
+                { name: "table_id", type: "integer", required: true, in: "path", description: "Table ID" }
+            ],
+            request_body: {
+                type: "application/json",
+                properties: {
+                    name: { type: "string", description: "Field name", required: true },
+                    type: { type: "string", description: "Field type (int, text, bool, etc.)", required: true },
+                    nullable: { type: "boolean", description: "Allow null values" },
+                    default: { type: "any", description: "Default value" }
+                }
+            }
+        },
+        {
+            method: "POST",
+            path: "/workspace/{workspace_id}/table/{table_id}/index",
+            tool_name: "createTableIndex",
+            description: "Create an index on table fields for query performance.",
+            parameters: [
+                { name: "workspace_id", type: "integer", required: true, in: "path", description: "Workspace ID" },
+                { name: "table_id", type: "integer", required: true, in: "path", description: "Table ID" }
+            ],
+            request_body: {
+                type: "application/json",
+                properties: {
+                    name: { type: "string", description: "Index name", required: true },
+                    type: { type: "string", description: "Index type: primary, unique, btree, search, spatial, vector", required: true },
+                    fields: { type: "array", description: "Fields to index", required: true }
+                }
+            }
+        },
+        {
+            method: "GET",
+            path: "/workspace/{workspace_id}/table/{table_id}/content",
+            tool_name: "getTableContent",
+            description: "Get table content/data (paginated).",
+            parameters: [
+                { name: "workspace_id", type: "integer", required: true, in: "path", description: "Workspace ID" },
+                { name: "table_id", type: "integer", required: true, in: "path", description: "Table ID" },
+                { name: "page", type: "integer", default: 1, description: "Page number" },
+                { name: "per_page", type: "integer", default: 50, description: "Items per page" }
+            ]
+        }
+    ],
+    schemas: {
+        Table: {
+            type: "object",
+            properties: {
+                id: { type: "integer" },
+                name: { type: "string" },
+                description: { type: "string" },
+                schema: {
+                    type: "array",
+                    items: {
+                        type: "object",
+                        properties: {
+                            name: { type: "string" },
+                            type: { type: "string" },
+                            nullable: { type: "boolean" },
+                            default: { type: "any" }
+                        }
+                    }
+                },
+                indexes: { type: "array" },
+                created_at: { type: "string", format: "date-time" },
+                updated_at: { type: "string", format: "date-time" }
+            }
+        },
+        FieldTypes: {
+            primitives: ["int", "text", "bool", "decimal", "email", "password"],
+            temporal: ["timestamp", "date"],
+            structured: ["json", "object"],
+            files: ["blob", "image", "video", "audio", "attachment"],
+            references: ["tableref", "tablerefuuid"],
+            special: ["enum", "vector", "geo_point", "geo_polygon", "geo_linestring"]
+        }
+    },
+    related_topics: ["function", "api", "workflows"]
+};

package/dist/meta_api_docs/topics/task.d.ts

@@ -0,0 +1,2 @@
+import type { TopicDoc } from "../types.js";
+export declare const taskDoc: TopicDoc;

package/dist/meta_api_docs/topics/task.js

@@ -0,0 +1,165 @@
+export const taskDoc = {
+    topic: "task",
+    title: "Scheduled Task Management",
+    description: `Tasks are scheduled jobs that run automatically based on a cron schedule. They're used for background processing, periodic data sync, automated maintenance, and more.
+
+## Key Concepts
+- Tasks run on a schedule (cron syntax)
+- No HTTP trigger - runs automatically
+- Can access databases, call functions, make external requests
+- Support draft/publish workflow
+- Restricted to paid accounts
+
+## Common Use Cases
+- Data cleanup and archiving
+- Report generation
+- External API sync
+- Notification sending
+- Cache warming`,
+    ai_hints: `- Tasks require paid account (will fail on free tier)
+- Use cron syntax for scheduling (e.g., "0 * * * *" for hourly)
+- Tasks have no HTTP inputs - all data comes from database or environment
+- Draft changes won't affect running schedule until published
+- Check task history to debug execution issues`,
+    endpoints: [
+        {
+            method: "GET",
+            path: "/workspace/{workspace_id}/task",
+            tool_name: "listTasks",
+            description: "List all scheduled tasks in a workspace.",
+            parameters: [
+                { name: "workspace_id", type: "integer", required: true, in: "path", description: "Workspace ID" },
+                { name: "page", type: "integer", default: 1, description: "Page number" },
+                { name: "per_page", type: "integer", default: 50, description: "Items per page" },
+                { name: "search", type: "string", description: "Search by task name" },
+                { name: "sort", type: "string", enum: ["id", "name", "created_at"], default: "created_at", description: "Sort field" },
+                { name: "order", type: "string", enum: ["asc", "desc"], default: "desc", description: "Sort direction" },
+                { name: "include_xanoscript", type: "boolean", default: false, description: "Include XanoScript code" },
+                { name: "include_draft", type: "boolean", default: false, description: "Include draft versions" },
+                { name: "branch", type: "string", description: "Filter by branch name" }
+            ]
+        },
+        {
+            method: "GET",
+            path: "/workspace/{workspace_id}/task/{task_id}",
+            tool_name: "getTask",
+            description: "Get details of a specific scheduled task.",
+            parameters: [
+                { name: "workspace_id", type: "integer", required: true, in: "path", description: "Workspace ID" },
+                { name: "task_id", type: "integer", required: true, in: "path", description: "Task ID" },
+                { name: "include_xanoscript", type: "boolean", default: false, description: "Include XanoScript code" },
+                { name: "include_draft", type: "boolean", default: false, description: "Include draft version" }
+            ]
+        },
+        {
+            method: "POST",
+            path: "/workspace/{workspace_id}/task",
+            tool_name: "createTask",
+            description: "Create a new scheduled task. Requires paid account.",
+            parameters: [
+                { name: "workspace_id", type: "integer", required: true, in: "path", description: "Workspace ID" }
+            ],
+            request_body: {
+                type: "application/json",
+                properties: {
+                    name: { type: "string", description: "Task name", required: true },
+                    description: { type: "string", description: "Task description" },
+                    schedule: { type: "string", description: "Cron expression (e.g., '0 * * * *' for hourly)", required: true },
+                    active: { type: "boolean", description: "Whether task is active", required: true },
+                    xanoscript: { type: "string", description: "XanoScript task definition", required: true }
+                }
+            },
+            example: {
+                method: "POST",
+                path: "/workspace/1/task",
+                body: {
+                    name: "cleanup_old_sessions",
+                    description: "Delete sessions older than 30 days",
+                    schedule: "0 3 * * *",
+                    active: true,
+                    xanoscript: `task cleanup_old_sessions {
+  stack {
+    var $cutoff {
+      value = now() - 30.days
+    }
+    db.sessions.query()
+      .where("created_at", "<", $cutoff)
+      .delete()
+  }
+}`
+                }
+            }
+        },
+        {
+            method: "PUT",
+            path: "/workspace/{workspace_id}/task/{task_id}",
+            tool_name: "updateTask",
+            description: "Update an existing scheduled task.",
+            parameters: [
+                { name: "workspace_id", type: "integer", required: true, in: "path", description: "Workspace ID" },
+                { name: "task_id", type: "integer", required: true, in: "path", description: "Task ID" },
+                { name: "publish", type: "boolean", default: true, description: "Publish changes immediately" }
+            ],
+            request_body: {
+                type: "application/json",
+                properties: {
+                    name: { type: "string", description: "Task name" },
+                    description: { type: "string", description: "Task description" },
+                    schedule: { type: "string", description: "Cron expression" },
+                    active: { type: "boolean", description: "Whether task is active" },
+                    xanoscript: { type: "string", description: "XanoScript task definition" }
+                }
+            }
+        },
+        {
+            method: "DELETE",
+            path: "/workspace/{workspace_id}/task/{task_id}",
+            tool_name: "deleteTask",
+            description: "Delete a scheduled task.",
+            parameters: [
+                { name: "workspace_id", type: "integer", required: true, in: "path", description: "Workspace ID" },
+                { name: "task_id", type: "integer", required: true, in: "path", description: "Task ID" }
+            ]
+        },
+        {
+            method: "PUT",
+            path: "/workspace/{workspace_id}/task/{task_id}/security",
+            tool_name: "updateTaskSecurity",
+            description: "Update security settings for the task.",
+            parameters: [
+                { name: "workspace_id", type: "integer", required: true, in: "path", description: "Workspace ID" },
+                { name: "task_id", type: "integer", required: true, in: "path", description: "Task ID" }
+            ],
+            request_body: {
+                type: "application/json",
+                properties: {
+                    guid: { type: "string", description: "Security group GUID" }
+                }
+            }
+        }
+    ],
+    schemas: {
+        Task: {
+            type: "object",
+            properties: {
+                id: { type: "integer" },
+                name: { type: "string" },
+                description: { type: "string" },
+                schedule: { type: "string", description: "Cron expression" },
+                active: { type: "boolean" },
+                xanoscript: { type: "string" },
+                created_at: { type: "string", format: "date-time" },
+                updated_at: { type: "string", format: "date-time" }
+            }
+        },
+        CronExamples: {
+            "every_minute": "* * * * *",
+            "every_hour": "0 * * * *",
+            "every_day_midnight": "0 0 * * *",
+            "every_day_3am": "0 3 * * *",
+            "every_monday": "0 0 * * 1",
+            "first_of_month": "0 0 1 * *"
+        }
+    },
+    related_topics: ["function", "history"]
+};

package/dist/meta_api_docs/topics/tool.d.ts

@@ -0,0 +1,2 @@
+import type { TopicDoc } from "../types.js";
+export declare const toolDoc: TopicDoc;