@xano/developer-mcp 1.0.26 → 1.0.27

package/dist/api_docs/topics/realtime.js

@@ -1,112 +0,0 @@
-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/api_docs/topics/start.d.ts

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

package/dist/api_docs/topics/start.js

@@ -1,107 +0,0 @@
-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/api_docs/topics/table.d.ts

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

package/dist/api_docs/topics/table.js

@@ -1,195 +0,0 @@
-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/api_docs/topics/task.d.ts

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

package/dist/api_docs/topics/task.js

@@ -1,165 +0,0 @@
-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/api_docs/topics/tool.d.ts

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