@xano/developer-mcp 1.0.40 → 1.0.42

package/README.md

@@ -29,7 +29,6 @@ An MCP server and standalone library that gives AI assistants superpowers for de
 This MCP server acts as a bridge between AI models and Xano's developer ecosystem, offering:
 
 - **Meta API Documentation** - Programmatically manage Xano workspaces, databases, APIs, functions, and more
-- **Run API Documentation** - Runtime execution, session management, and XanoScript execution
 - **CLI Documentation** - Command-line interface for local development, code sync, and execution
 - **XanoScript Documentation** - Language reference with context-aware docs based on file type
 - **Code Validation** - Syntax checking with the official XanoScript language server
@@ -162,7 +161,6 @@ import {
   validateXanoscript,
   xanoscriptDocs,
   metaApiDocs,
-  runApiDocs,
   cliDocs,
   mcpVersion
 } from '@xano/developer-mcp';
@@ -173,6 +171,7 @@ import {
 ```typescript
 import { validateXanoscript } from '@xano/developer-mcp';
 
+// Validate code directly
 const result = validateXanoscript({ code: 'var:result = 1 + 2' });
 
 if (result.valid) {
@@ -183,6 +182,13 @@ if (result.valid) {
     console.log(`  Line ${error.range.start.line + 1}: ${error.message}`);
   });
 }
+
+// Validate a file
+const fileResult = validateXanoscript({ file_path: './functions/utils.xs' });
+
+// Batch validate a directory
+const dirResult = validateXanoscript({ directory: './apis', pattern: '**/*.xs' });
+console.log(`${dirResult.valid_files}/${dirResult.total_files} files valid`);
 ```
 
 ### Get XanoScript Documentation
@@ -222,19 +228,6 @@ const workspaceDocs = metaApiDocs({
 console.log(workspaceDocs.documentation);
 ```
 
-### Get Run API Documentation
-
-```typescript
-import { runApiDocs } from '@xano/developer-mcp';
-
-const sessionDocs = runApiDocs({
-  topic: 'session',
-  detail_level: 'detailed'
-});
-
-console.log(sessionDocs.documentation);
-```
-
 ### Get CLI Documentation
 
 ```typescript
@@ -260,7 +253,6 @@ console.log(`Using version ${version}`);
 | `validateXanoscript` | Validate XanoScript code and get detailed error information |
 | `xanoscriptDocs` | Get XanoScript language documentation |
 | `metaApiDocs` | Get Meta API documentation |
-| `runApiDocs` | Get Run API documentation |
 | `cliDocs` | Get CLI documentation |
 | `mcpVersion` | Get the package version |
 | `toolDefinitions` | MCP tool definitions (for building custom MCP servers) |
@@ -277,7 +269,6 @@ import type {
   ParserDiagnostic,
   XanoscriptDocsArgs,
   MetaApiDocsArgs,
-  RunApiDocsArgs,
   CliDocsArgs,
   ToolResult
 } from '@xano/developer-mcp';
@@ -302,21 +293,38 @@ import '@xano/developer-mcp/server';
 
 ### 1. `validate_xanoscript`
 
-Validates XanoScript code for syntax errors. The language server auto-detects the object type from the code syntax.
+Validates XanoScript code for syntax errors. Supports multiple input methods. The language server auto-detects the object type from the code syntax.
 
 **Parameters:**
 | Parameter | Type | Required | Description |
 |-----------|------|----------|-------------|
-| `code` | string | Yes | The XanoScript code to validate |
+| `code` | string | No | The XanoScript code to validate as a string |
+| `file_path` | string | No | Path to a single `.xs` file to validate |
+| `file_paths` | string[] | No | Array of file paths for batch validation |
+| `directory` | string | No | Directory path to validate all `.xs` files recursively |
+| `pattern` | string | No | Glob pattern to filter files when using `directory` (default: `**/*.xs`) |
 
-**Example:**
+> One of `code`, `file_path`, `file_paths`, or `directory` is required.
+
+**Examples:**
 ```
-validate_xanoscript({
-  code: "var:result = 1 + 2"
-})
+// Validate code directly
+validate_xanoscript({ code: "var:result = 1 + 2" })
+
+// Validate a single file
+validate_xanoscript({ file_path: "functions/utils/format.xs" })
+
+// Validate multiple files
+validate_xanoscript({ file_paths: ["apis/users/get.xs", "apis/users/create.xs"] })
+
+// Validate all .xs files in a directory
+validate_xanoscript({ directory: "apis/users" })
+
+// Validate with a specific pattern
+validate_xanoscript({ directory: "src", pattern: "apis/**/*.xs" })
 ```
 
-**Returns:** List of errors with line/column positions, or confirmation of validity.
+**Returns:** List of errors with line/column positions and helpful suggestions, or confirmation of validity.
 
 ### 2. `xanoscript_docs`
 
@@ -336,6 +344,7 @@ Retrieves XanoScript programming language documentation with context-aware suppo
 | `readme` | XanoScript overview, workspace structure, and quick reference |
 | `cheatsheet` | Quick reference for 20 most common XanoScript patterns (recommended first stop) |
 | `syntax` | Expressions, operators, and filters for all XanoScript code |
+| `quickstart` | Common patterns, quick reference, and common mistakes to avoid |
 | `types` | Data types, input blocks, and validation |
 | `tables` | Database schema definitions with indexes and relationships |
 | `functions` | Reusable function stacks with inputs and responses |
@@ -363,6 +372,9 @@ Retrieves XanoScript programming language documentation with context-aware suppo
 | `schema` | Runtime schema parsing and validation |
 | `security` | Security best practices for authentication and authorization |
 | `streaming` | Streaming data from files, requests, and responses |
+| `middleware` | Request/response interceptors for functions, queries, tasks, and tools |
+| `branch` | Branch-level settings: middleware, history retention, visual styling |
+| `workspace` | Workspace-level settings: environment variables, preferences, realtime |
 
 **Examples:**
 ```
@@ -382,46 +394,7 @@ xanoscript_docs({ file_path: "api/users/create_post.xs" })
 xanoscript_docs({ topic: "database", mode: "quick_reference" })
 ```
 
-### 3. `run_api_docs`
-
-Get documentation for Xano's Run API. Use this to understand runtime execution, session management, and XanoScript execution.
-
-**Important:** The Run API uses a fixed base URL: `https://app.dev.xano.com/api:run/<endpoint>` (NOT your Xano instance URL)
-
-**Parameters:**
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `topic` | string | Yes | Documentation topic to retrieve |
-| `detail_level` | string | No | `overview`, `detailed` (default), or `examples` |
-| `include_schemas` | boolean | No | Include JSON schemas for requests/responses (default: true) |
-
-**Available Topics:**
-
-| Topic | Description |
-|-------|-------------|
-| `start` | Getting started with the Run API |
-| `run` | Execute XanoScript code and API endpoints |
-| `session` | Session management for stateful execution |
-| `history` | Execution history and debugging |
-| `data` | Data operations and variable management |
-| `workflows` | Step-by-step workflow guides |
-
-**Examples:**
-```
-// Get overview of Run API
-run_api_docs({ topic: "start" })
-
-// Get detailed run endpoint documentation
-run_api_docs({ topic: "run", detail_level: "detailed" })
-
-// Get examples without schemas (smaller context)
-run_api_docs({ topic: "session", detail_level: "examples", include_schemas: false })
-
-// Step-by-step workflow guides
-run_api_docs({ topic: "workflows" })
-```
-
-### 4. `mcp_version`
+### 3. `mcp_version`
 
 Get the current version of the Xano Developer MCP server.
 
@@ -434,7 +407,7 @@ Get the current version of the Xano Developer MCP server.
 mcp_version()
 ```
 
-### 5. `meta_api_docs`
+### 4. `meta_api_docs`
 
 Get documentation for Xano's Meta API. Use this to understand how to programmatically manage Xano workspaces, databases, APIs, functions, agents, and more.
 
@@ -482,7 +455,7 @@ meta_api_docs({ topic: "api", detail_level: "examples", include_schemas: false }
 meta_api_docs({ topic: "workflows" })
 ```
 
-### 6. `cli_docs`
+### 5. `cli_docs`
 
 Get documentation for the Xano CLI. The CLI is **optional but recommended** for local development workflows. Not all users will have it installed.
 
@@ -504,6 +477,7 @@ Use this tool to understand CLI commands for local development, code synchroniza
 | `start` | Getting started with the CLI - installation and setup |
 | `profile` | Profile management - credentials and multi-environment setup |
 | `workspace` | Workspace operations - pull/push code sync |
+| `branch` | Branch management - list, switch, create, and delete branches |
 | `function` | Function management - list, get, create, edit |
 | `run` | Run API commands - execute code, manage projects/sessions |
 | `static_host` | Static hosting - deploy frontend builds |
@@ -533,6 +507,7 @@ The server also exposes XanoScript documentation as MCP resources for direct acc
 | `xanoscript://docs/readme` | Overview and quick reference |
 | `xanoscript://docs/cheatsheet` | Quick reference for 20 most common patterns |
 | `xanoscript://docs/syntax` | Expressions, operators, and filters |
+| `xanoscript://docs/quickstart` | Common patterns and common mistakes to avoid |
 | `xanoscript://docs/types` | Data types and validation |
 | `xanoscript://docs/tables` | Database schema definitions |
 | `xanoscript://docs/functions` | Reusable function stacks |
@@ -560,12 +535,15 @@ The server also exposes XanoScript documentation as MCP resources for direct acc
 | `xanoscript://docs/schema` | Runtime schema parsing |
 | `xanoscript://docs/security` | Security best practices |
 | `xanoscript://docs/streaming` | Data streaming operations |
+| `xanoscript://docs/middleware` | Request/response interceptors |
+| `xanoscript://docs/branch` | Branch-level settings |
+| `xanoscript://docs/workspace` | Workspace-level settings |
 
 ## npm Scripts
 
 | Script | Command | Description |
 |--------|---------|-------------|
-| `build` | `tsc` | Compile TypeScript to JavaScript |
+| `build` | `tsc && cp -r src/xanoscript_docs dist/` | Compile TypeScript and copy docs |
 | `start` | `node dist/index.js` | Run the MCP server |
 | `dev` | `tsc && node dist/index.js` | Build and run in development |
 | `test` | `vitest run` | Run unit tests |
@@ -589,7 +567,6 @@ xano-developer-mcp/
 │   │   ├── xanoscript_docs.ts          # XanoScript docs tool
 │   │   ├── mcp_version.ts              # Version tool
 │   │   ├── meta_api_docs.ts            # Meta API docs tool wrapper
-│   │   ├── run_api_docs.ts             # Run API docs tool wrapper
 │   │   └── cli_docs.ts                 # CLI docs tool wrapper
 │   ├── meta_api_docs/                  # Meta API documentation
 │   │   ├── index.ts                    # API docs handler
@@ -599,12 +576,6 @@ xano-developer-mcp/
 │   │   ├── format.ts                   # Documentation formatter
 │   │   ├── format.test.ts              # Tests for formatter
 │   │   └── topics/                     # Individual topic modules
-│   ├── run_api_docs/                   # Run API documentation
-│   │   ├── index.ts                    # Run API handler
-│   │   ├── index.test.ts               # Tests for index
-│   │   ├── format.ts                   # Documentation formatter
-│   │   ├── format.test.ts              # Tests for formatter
-│   │   └── topics/                     # Individual topic modules
 │   ├── cli_docs/                       # Xano CLI documentation
 │   │   ├── index.ts                    # CLI docs handler
 │   │   ├── types.ts                    # Type definitions
@@ -626,7 +597,7 @@ xano-developer-mcp/
 | Package | Version | Purpose |
 |---------|---------|---------|
 | `@modelcontextprotocol/sdk` | ^1.26.0 | Official MCP SDK |
-| `@xano/xanoscript-language-server` | ^11.6.3 | XanoScript parser and validation |
+| `@xano/xanoscript-language-server` | ^11.6.5 | XanoScript parser and validation |
 | `minimatch` | ^10.1.2 | Glob pattern matching for context-aware docs |
 
 ### Dev Dependencies
@@ -655,8 +626,6 @@ Xano Developer MCP Server
     │
     ├─► meta_api_docs → Meta API documentation with detail levels
     │
-    ├─► run_api_docs → Run API documentation for runtime execution
-    │
     ├─► cli_docs → CLI documentation for local development workflows
     │
     ├─► mcp_version → Returns server version from package.json
@@ -666,7 +635,7 @@ Xano Developer MCP Server
 
 ## Authentication
 
-The MCP server and library functions do not require authentication. However, when using the documented APIs (Meta API, Run API) to interact with actual Xano services, you will need appropriate Xano API credentials. See the `meta_api_docs` and `run_api_docs` tools for authentication details.
+The MCP server and library functions do not require authentication. However, when using the documented APIs (Meta API) to interact with actual Xano services, you will need appropriate Xano API credentials. See the `meta_api_docs` tool for authentication details.
 
 ## Development
 
@@ -717,8 +686,6 @@ npm run test:coverage
 | `meta_api_docs/index.ts` | `meta_api_docs/index.test.ts` | Meta API documentation handler and topic management |
 | `meta_api_docs/format.ts` | `meta_api_docs/format.test.ts` | Documentation formatting for endpoints, examples, and patterns |
 | `meta_api_docs/types.ts` | `meta_api_docs/types.test.ts` | Type structure validation |
-| `run_api_docs/index.ts` | `run_api_docs/index.test.ts` | Run API documentation handler |
-| `run_api_docs/format.ts` | `run_api_docs/format.test.ts` | Run API formatting with correct base URL |
 
 ### Test Structure
 
@@ -734,10 +701,6 @@ src/
 │   ├── format.ts
 │   ├── format.test.ts          # Tests for format.ts
 │   └── ...
-└── run_api_docs/
-    ├── index.ts
-    ├── index.test.ts           # Tests for index.ts
-    └── ...
 ```
 
 ### Writing Tests

package/dist/cli_docs/index.js

@@ -74,13 +74,18 @@ ${getTopicDescriptions()}
             topic: {
                 type: "string",
                 enum: getTopicNames(),
-                description: "Documentation topic to retrieve",
+                description: "Documentation topic to retrieve. Start with 'start' for installation and setup. " +
+                    "Example: topic='function' for function management commands, topic='run' for running XanoScript locally.",
             },
             detail_level: {
                 type: "string",
                 enum: ["overview", "detailed", "examples"],
                 default: "detailed",
-                description: "Level of detail: overview (brief), detailed (full docs), examples (with examples)",
+                description: "Level of detail to return. " +
+                    "'overview' = brief summary of commands and their purpose. " +
+                    "'detailed' = full command reference with flags and arguments. " +
+                    "'examples' = includes usage examples for each command. " +
+                    "Default: 'detailed'.",
             },
         },
         required: ["topic"],

package/dist/lib.d.ts

@@ -10,7 +10,6 @@
  *   validateXanoscript,
  *   xanoscriptDocs,
  *   metaApiDocs,
- *   runApiDocs,
  *   cliDocs,
  *   mcpVersion
  * } from '@xano/developer-mcp';
@@ -46,8 +45,7 @@ export { validateXanoscript, type ValidateXanoscriptArgs, type ValidationResult,
 export { xanoscriptDocs, getXanoscriptDocsPath, setXanoscriptDocsPath, type XanoscriptDocsArgs, type XanoscriptDocsResult, } from "./tools/xanoscript_docs.js";
 export { mcpVersion, getServerVersion, setServerVersion, type McpVersionResult, } from "./tools/mcp_version.js";
 export { metaApiDocs, metaApiTopics, getMetaApiTopicNames, getMetaApiTopicDescriptions, type MetaApiDocsArgs, type MetaApiDocsResult, } from "./tools/meta_api_docs.js";
-export { runApiDocs, runApiTopics, getRunApiTopicNames, getRunApiTopicDescriptions, type RunApiDocsArgs, type RunApiDocsResult, } from "./tools/run_api_docs.js";
 export { cliDocs, cliTopics, getCliTopicNames, getCliTopicDescriptions, type CliDocsArgs, type CliDocsResult, } from "./tools/cli_docs.js";
 export { type ToolResult, toMcpResponse } from "./tools/types.js";
 export { XANOSCRIPT_DOCS_V2, readXanoscriptDocsV2, getDocsForFilePath, extractQuickReference, getXanoscriptDocsVersion, getTopicNames as getXanoscriptTopicNames, getTopicDescriptions as getXanoscriptTopicDescriptions, type DocConfig, } from "./xanoscript.js";
-export { toolDefinitions, handleTool, validateXanoscriptToolDefinition, xanoscriptDocsToolDefinition, mcpVersionToolDefinition, metaApiDocsToolDefinition, runApiDocsToolDefinition, cliDocsToolDefinition, } from "./tools/index.js";
+export { toolDefinitions, handleTool, validateXanoscriptToolDefinition, xanoscriptDocsToolDefinition, mcpVersionToolDefinition, metaApiDocsToolDefinition, cliDocsToolDefinition, } from "./tools/index.js";

package/dist/lib.js

@@ -10,7 +10,6 @@
  *   validateXanoscript,
  *   xanoscriptDocs,
  *   metaApiDocs,
- *   runApiDocs,
  *   cliDocs,
  *   mcpVersion
  * } from '@xano/developer-mcp';
@@ -53,8 +52,6 @@ export { xanoscriptDocs, getXanoscriptDocsPath, setXanoscriptDocsPath, } from ".
 export { mcpVersion, getServerVersion, setServerVersion, } from "./tools/mcp_version.js";
 // Meta API Documentation
 export { metaApiDocs, metaApiTopics, getMetaApiTopicNames, getMetaApiTopicDescriptions, } from "./tools/meta_api_docs.js";
-// Run API Documentation
-export { runApiDocs, runApiTopics, getRunApiTopicNames, getRunApiTopicDescriptions, } from "./tools/run_api_docs.js";
 // CLI Documentation
 export { cliDocs, cliTopics, getCliTopicNames, getCliTopicDescriptions, } from "./tools/cli_docs.js";
 // =============================================================================
@@ -68,4 +65,4 @@ export { XANOSCRIPT_DOCS_V2, readXanoscriptDocsV2, getDocsForFilePath, extractQu
 // =============================================================================
 // MCP Tool Definitions (for building custom MCP servers)
 // =============================================================================
-export { toolDefinitions, handleTool, validateXanoscriptToolDefinition, xanoscriptDocsToolDefinition, mcpVersionToolDefinition, metaApiDocsToolDefinition, runApiDocsToolDefinition, cliDocsToolDefinition, } from "./tools/index.js";
+export { toolDefinitions, handleTool, validateXanoscriptToolDefinition, xanoscriptDocsToolDefinition, mcpVersionToolDefinition, metaApiDocsToolDefinition, cliDocsToolDefinition, } from "./tools/index.js";

package/dist/meta_api_docs/format.d.ts

@@ -13,8 +13,4 @@ export interface FormatConfig {
  * Default config for Meta API
  */
 export declare const META_API_CONFIG: FormatConfig;
-/**
- * Config for Run API
- */
-export declare const RUN_API_CONFIG: FormatConfig;
 export declare function formatDocumentation(doc: TopicDoc, detailLevel?: DetailLevel, includeSchemas?: boolean, config?: FormatConfig): string;

package/dist/meta_api_docs/format.js

@@ -13,21 +13,6 @@ Authorization: \`Bearer <your-access-token>\`
 `,
     toolName: "meta_api_docs",
 };
-/**
- * Config for Run API
- */
-export const RUN_API_CONFIG = {
-    baseUrlInfo: `## Base URL
-\`\`\`
-https://app.dev.xano.com/api:run/<endpoint>
-\`\`\`
-
-**Important:** This is a fixed URL - NOT your Xano instance URL. All Run API requests go to this central endpoint.
-
-Authorization: \`Bearer <your-access-token>\`
-`,
-    toolName: "run_api_docs",
-};
 function formatParameter(param) {
     const required = param.required ? " (required)" : "";
     const defaultVal = param.default !== undefined ? ` [default: ${param.default}]` : "";

package/dist/meta_api_docs/format.test.js

@@ -1,5 +1,5 @@
 import { describe, it, expect } from "vitest";
-import { formatDocumentation, META_API_CONFIG, RUN_API_CONFIG, } from "./format.js";
+import { formatDocumentation, META_API_CONFIG, } from "./format.js";
 describe("meta_api_docs/format", () => {
     describe("META_API_CONFIG", () => {
         it("should have correct base URL info", () => {
@@ -7,12 +7,6 @@ describe("meta_api_docs/format", () => {
             expect(META_API_CONFIG.toolName).toBe("meta_api_docs");
         });
     });
-    describe("RUN_API_CONFIG", () => {
-        it("should have correct base URL info", () => {
-            expect(RUN_API_CONFIG.baseUrlInfo).toContain("https://app.dev.xano.com/api:run/");
-            expect(RUN_API_CONFIG.toolName).toBe("run_api_docs");
-        });
-    });
     describe("formatDocumentation", () => {
         const minimalDoc = {
             topic: "test",
@@ -225,8 +219,12 @@ describe("meta_api_docs/format", () => {
             expect(result).toContain("meta_api_docs");
         });
         it("should use custom config", () => {
-            const result = formatDocumentation({ ...minimalDoc, patterns: [{ name: "Test", steps: ["step"] }] }, "detailed", true, RUN_API_CONFIG);
-            expect(result).toContain("https://app.dev.xano.com/api:run/");
+            const customConfig = {
+                baseUrlInfo: "## Base URL\nhttps://custom.example.com/api/",
+                toolName: "custom_docs",
+            };
+            const result = formatDocumentation({ ...minimalDoc, patterns: [{ name: "Test", steps: ["step"] }] }, "detailed", true, customConfig);
+            expect(result).toContain("https://custom.example.com/api/");
         });
         describe("detail levels", () => {
             const docWithAll = {

package/dist/meta_api_docs/index.js

@@ -92,18 +92,25 @@ ${getTopicDescriptions()}
             topic: {
                 type: "string",
                 enum: getTopicNames(),
-                description: "Documentation topic to retrieve",
+                description: "Documentation topic to retrieve. Start with 'start' for an overview of the Meta API. " +
+                    "Example: topic='workspace' for workspace management endpoints, topic='table' for database table operations.",
             },
             detail_level: {
                 type: "string",
                 enum: ["overview", "detailed", "examples"],
                 default: "detailed",
-                description: "Level of detail: overview (brief), detailed (full docs), examples (with code examples)",
+                description: "Level of detail to return. " +
+                    "'overview' = brief summary of endpoints and their purpose. " +
+                    "'detailed' = full API reference with parameters, headers, and response formats. " +
+                    "'examples' = includes curl and fetch code examples for each endpoint. " +
+                    "Default: 'detailed'.",
             },
             include_schemas: {
                 type: "boolean",
                 default: true,
-                description: "Include JSON schemas for requests/responses",
+                description: "Include JSON schemas for request bodies and response payloads. " +
+                    "Useful for understanding the expected data format. Set to false to reduce response size. " +
+                    "Default: true.",
             },
         },
         required: ["topic"],

package/dist/tools/index.d.ts

@@ -19,7 +19,6 @@
  *   validateXanoscript,
  *   xanoscriptDocs,
  *   metaApiDocs,
- *   runApiDocs,
  *   cliDocs,
  *   mcpVersion
  * } from '@xano/developer-mcp';
@@ -33,12 +32,11 @@ import { validateXanoscript, validateXanoscriptTool, validateXanoscriptToolDefin
 import { xanoscriptDocs, xanoscriptDocsTool, xanoscriptDocsToolDefinition, getXanoscriptDocsPath, setXanoscriptDocsPath, type XanoscriptDocsArgs, type XanoscriptDocsResult } from "./xanoscript_docs.js";
 import { mcpVersion, mcpVersionTool, mcpVersionToolDefinition, getServerVersion, setServerVersion, type McpVersionResult } from "./mcp_version.js";
 import { metaApiDocs, metaApiDocsTool, metaApiDocsToolDefinition, metaApiTopics, getMetaApiTopicNames, getMetaApiTopicDescriptions, type MetaApiDocsArgs, type MetaApiDocsResult } from "./meta_api_docs.js";
-import { runApiDocs, runApiDocsTool, runApiDocsToolDefinition, runApiTopics, getRunApiTopicNames, getRunApiTopicDescriptions, type RunApiDocsArgs, type RunApiDocsResult } from "./run_api_docs.js";
 import { cliDocs, cliDocsTool, cliDocsToolDefinition, cliTopics, getCliTopicNames, getCliTopicDescriptions, type CliDocsArgs, type CliDocsResult } from "./cli_docs.js";
 import { type ToolResult, toMcpResponse } from "./types.js";
-export { validateXanoscript, TYPE_ALIASES, RESERVED_VARIABLES, type ValidateXanoscriptArgs, type ValidationResult, type BatchValidationResult, type SingleFileValidationResult, type ParserDiagnostic, xanoscriptDocs, getXanoscriptDocsPath, setXanoscriptDocsPath, type XanoscriptDocsArgs, type XanoscriptDocsResult, mcpVersion, getServerVersion, setServerVersion, type McpVersionResult, metaApiDocs, metaApiTopics, getMetaApiTopicNames, getMetaApiTopicDescriptions, type MetaApiDocsArgs, type MetaApiDocsResult, runApiDocs, runApiTopics, getRunApiTopicNames, getRunApiTopicDescriptions, type RunApiDocsArgs, type RunApiDocsResult, cliDocs, cliTopics, getCliTopicNames, getCliTopicDescriptions, type CliDocsArgs, type CliDocsResult, type ToolResult, toMcpResponse, };
-export { validateXanoscriptTool, xanoscriptDocsTool, mcpVersionTool, metaApiDocsTool, runApiDocsTool, cliDocsTool, };
-export { validateXanoscriptToolDefinition, xanoscriptDocsToolDefinition, mcpVersionToolDefinition, metaApiDocsToolDefinition, runApiDocsToolDefinition, cliDocsToolDefinition, };
+export { validateXanoscript, TYPE_ALIASES, RESERVED_VARIABLES, type ValidateXanoscriptArgs, type ValidationResult, type BatchValidationResult, type SingleFileValidationResult, type ParserDiagnostic, xanoscriptDocs, getXanoscriptDocsPath, setXanoscriptDocsPath, type XanoscriptDocsArgs, type XanoscriptDocsResult, mcpVersion, getServerVersion, setServerVersion, type McpVersionResult, metaApiDocs, metaApiTopics, getMetaApiTopicNames, getMetaApiTopicDescriptions, type MetaApiDocsArgs, type MetaApiDocsResult, cliDocs, cliTopics, getCliTopicNames, getCliTopicDescriptions, type CliDocsArgs, type CliDocsResult, type ToolResult, toMcpResponse, };
+export { validateXanoscriptTool, xanoscriptDocsTool, mcpVersionTool, metaApiDocsTool, cliDocsTool, };
+export { validateXanoscriptToolDefinition, xanoscriptDocsToolDefinition, mcpVersionToolDefinition, metaApiDocsToolDefinition, cliDocsToolDefinition, };
 /**
  * All tool definitions for MCP server registration
  */

package/dist/tools/index.js

@@ -19,7 +19,6 @@
  *   validateXanoscript,
  *   xanoscriptDocs,
  *   metaApiDocs,
- *   runApiDocs,
  *   cliDocs,
  *   mcpVersion
  * } from '@xano/developer-mcp';
@@ -36,7 +35,6 @@ import { validateXanoscript, validateXanoscriptTool, validateXanoscriptToolDefin
 import { xanoscriptDocs, xanoscriptDocsTool, xanoscriptDocsToolDefinition, getXanoscriptDocsPath, setXanoscriptDocsPath, } from "./xanoscript_docs.js";
 import { mcpVersion, mcpVersionTool, mcpVersionToolDefinition, getServerVersion, setServerVersion, } from "./mcp_version.js";
 import { metaApiDocs, metaApiDocsTool, metaApiDocsToolDefinition, metaApiTopics, getMetaApiTopicNames, getMetaApiTopicDescriptions, } from "./meta_api_docs.js";
-import { runApiDocs, runApiDocsTool, runApiDocsToolDefinition, runApiTopics, getRunApiTopicNames, getRunApiTopicDescriptions, } from "./run_api_docs.js";
 import { cliDocs, cliDocsTool, cliDocsToolDefinition, cliTopics, getCliTopicNames, getCliTopicDescriptions, } from "./cli_docs.js";
 import { toMcpResponse } from "./types.js";
 // =============================================================================
@@ -51,18 +49,16 @@ xanoscriptDocs, getXanoscriptDocsPath, setXanoscriptDocsPath,
 mcpVersion, getServerVersion, setServerVersion, 
 // Meta API Documentation
 metaApiDocs, metaApiTopics, getMetaApiTopicNames, getMetaApiTopicDescriptions, 
-// Run API Documentation
-runApiDocs, runApiTopics, getRunApiTopicNames, getRunApiTopicDescriptions, 
 // CLI Documentation
 cliDocs, cliTopics, getCliTopicNames, getCliTopicDescriptions, toMcpResponse, };
 // =============================================================================
 // Tool Result Functions (for internal MCP usage)
 // =============================================================================
-export { validateXanoscriptTool, xanoscriptDocsTool, mcpVersionTool, metaApiDocsTool, runApiDocsTool, cliDocsTool, };
+export { validateXanoscriptTool, xanoscriptDocsTool, mcpVersionTool, metaApiDocsTool, cliDocsTool, };
 // =============================================================================
 // MCP Tool Definitions
 // =============================================================================
-export { validateXanoscriptToolDefinition, xanoscriptDocsToolDefinition, mcpVersionToolDefinition, metaApiDocsToolDefinition, runApiDocsToolDefinition, cliDocsToolDefinition, };
+export { validateXanoscriptToolDefinition, xanoscriptDocsToolDefinition, mcpVersionToolDefinition, metaApiDocsToolDefinition, cliDocsToolDefinition, };
 /**
  * All tool definitions for MCP server registration
  */
@@ -71,7 +67,6 @@ export const toolDefinitions = [
     xanoscriptDocsToolDefinition,
     mcpVersionToolDefinition,
     metaApiDocsToolDefinition,
-    runApiDocsToolDefinition,
     cliDocsToolDefinition,
 ];
 // =============================================================================
@@ -91,8 +86,6 @@ export function handleTool(name, args) {
             return mcpVersionTool();
         case "meta_api_docs":
             return metaApiDocsTool(args);
-        case "run_api_docs":
-            return runApiDocsTool(args);
         case "cli_docs":
             return cliDocsTool(args);
         default:

package/dist/tools/validate_xanoscript.js

@@ -399,24 +399,29 @@ export const validateXanoscriptToolDefinition = {
         properties: {
             code: {
                 type: "string",
-                description: "The XanoScript code to validate as a string. Use file_path instead if the code contains special characters that are hard to escape.",
+                description: "The XanoScript code to validate as a string. Use file_path instead if the code contains special characters that are hard to escape. " +
+                    "Example: \"var $name:text = 'hello'\\nreturn $name\"",
             },
             file_path: {
                 type: "string",
-                description: "Path to a single XanoScript file to validate. Easier than passing code directly - avoids escaping issues.",
+                description: "Path to a single XanoScript file to validate. Easier than passing code directly - avoids escaping issues. " +
+                    "Example: \"functions/utils/format.xs\"",
             },
             file_paths: {
                 type: "array",
                 items: { type: "string" },
-                description: "Array of file paths for batch validation. Returns a summary with per-file results.",
+                description: "Array of file paths for batch validation. Returns a summary with per-file results. " +
+                    "Example: [\"apis/users/get.xs\", \"apis/users/create.xs\", \"functions/utils/format.xs\"]",
             },
             directory: {
                 type: "string",
-                description: "Directory path to validate. Validates all .xs files recursively. Use with 'pattern' to filter.",
+                description: "Directory path to validate. Validates all .xs files recursively. Use with 'pattern' to filter specific subdirectories or files. " +
+                    "Example: \"apis/users\"",
             },
             pattern: {
                 type: "string",
-                description: 'Glob pattern to filter files when using directory (default: "**/*.xs"). Example: "apis/**/*.xs"',
+                description: "Glob pattern to filter files when using 'directory' (default: \"**/*.xs\"). " +
+                    "Examples: \"apis/**/*.xs\" to match only API files, \"**/create.xs\" to match all create files.",
             },
         },
         required: [],

package/dist/tools/xanoscript_docs.js

@@ -110,18 +110,24 @@ export const xanoscriptDocsToolDefinition = {
         properties: {
             topic: {
                 type: "string",
-                description: "Documentation topic. Available: " + getTopicDescriptions(),
+                description: "Documentation topic to retrieve. Call without any parameters to get the README overview. " +
+                    "Example: topic='syntax' for language syntax, topic='database' for database operations, topic='types' for type system.\n\n" +
+                    "Available topics:\n" + getTopicDescriptions(),
             },
             file_path: {
                 type: "string",
-                description: "File path being edited (e.g., 'apis/users/create.xs', 'functions/utils/format.xs'). " +
-                    "Returns all relevant docs based on file type using applyTo pattern matching.",
+                description: "File path being edited. Returns all relevant docs automatically based on the file type and location. " +
+                    "Uses applyTo pattern matching to select applicable topics. " +
+                    "Example: 'apis/users/create.xs' returns API, database, and syntax docs. " +
+                    "'functions/utils/format.xs' returns function and syntax docs.",
             },
             mode: {
                 type: "string",
                 enum: ["full", "quick_reference"],
-                description: "full = complete documentation, quick_reference = compact Quick Reference sections only. " +
-                    "Use quick_reference for smaller context window usage.",
+                description: "'full' = complete documentation with explanations and examples. " +
+                    "'quick_reference' = compact cheatsheet with just syntax patterns and signatures. " +
+                    "Use 'quick_reference' to save context window space when you just need a reminder. " +
+                    "Default: 'full'.",
             },
         },
         required: [],