@xano/developer-mcp 1.0.31 → 1.0.33

package/dist/lib.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @xano/developer-mcp Library Entry Point
+ *
+ * This module exports all tools for use as a standalone library.
+ * Use this when you want to use the Xano tools outside of the MCP context.
+ *
+ * @example
+ * ```ts
+ * import {
+ *   validateXanoscript,
+ *   xanoscriptDocs,
+ *   metaApiDocs,
+ *   runApiDocs,
+ *   cliDocs,
+ *   mcpVersion
+ * } from '@xano/developer-mcp';
+ *
+ * // Validate XanoScript code
+ * const validation = validateXanoscript({ code: 'return 1 + 1' });
+ * if (validation.valid) {
+ *   console.log('Code is valid!');
+ * } else {
+ *   console.log('Errors:', validation.errors);
+ * }
+ *
+ * // Get XanoScript documentation
+ * const docs = xanoscriptDocs({ topic: 'syntax', mode: 'quick_reference' });
+ * console.log(docs.documentation);
+ *
+ * // Get Meta API documentation
+ * const apiDocs = metaApiDocs({ topic: 'workspace', detail_level: 'examples' });
+ * console.log(apiDocs.documentation);
+ *
+ * // Get CLI documentation
+ * const cliDocs = cliDocs({ topic: 'start' });
+ * console.log(cliDocs.documentation);
+ *
+ * // Get version
+ * const { version } = mcpVersion();
+ * console.log(`Version: ${version}`);
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { validateXanoscript, type ValidateXanoscriptArgs, type ValidationResult, type ParserDiagnostic, } from "./tools/validate_xanoscript.js";
+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";

package/dist/lib.js

@@ -0,0 +1,71 @@
+/**
+ * @xano/developer-mcp Library Entry Point
+ *
+ * This module exports all tools for use as a standalone library.
+ * Use this when you want to use the Xano tools outside of the MCP context.
+ *
+ * @example
+ * ```ts
+ * import {
+ *   validateXanoscript,
+ *   xanoscriptDocs,
+ *   metaApiDocs,
+ *   runApiDocs,
+ *   cliDocs,
+ *   mcpVersion
+ * } from '@xano/developer-mcp';
+ *
+ * // Validate XanoScript code
+ * const validation = validateXanoscript({ code: 'return 1 + 1' });
+ * if (validation.valid) {
+ *   console.log('Code is valid!');
+ * } else {
+ *   console.log('Errors:', validation.errors);
+ * }
+ *
+ * // Get XanoScript documentation
+ * const docs = xanoscriptDocs({ topic: 'syntax', mode: 'quick_reference' });
+ * console.log(docs.documentation);
+ *
+ * // Get Meta API documentation
+ * const apiDocs = metaApiDocs({ topic: 'workspace', detail_level: 'examples' });
+ * console.log(apiDocs.documentation);
+ *
+ * // Get CLI documentation
+ * const cliDocs = cliDocs({ topic: 'start' });
+ * console.log(cliDocs.documentation);
+ *
+ * // Get version
+ * const { version } = mcpVersion();
+ * console.log(`Version: ${version}`);
+ * ```
+ *
+ * @packageDocumentation
+ */
+// =============================================================================
+// Main Tool Exports
+// =============================================================================
+// Validation
+export { validateXanoscript, } from "./tools/validate_xanoscript.js";
+// XanoScript Documentation
+export { xanoscriptDocs, getXanoscriptDocsPath, setXanoscriptDocsPath, } from "./tools/xanoscript_docs.js";
+// MCP Version
+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";
+// =============================================================================
+// Utility Exports
+// =============================================================================
+export { toMcpResponse } from "./tools/types.js";
+// =============================================================================
+// XanoScript Core Exports (for advanced usage)
+// =============================================================================
+export { XANOSCRIPT_DOCS_V2, readXanoscriptDocsV2, getDocsForFilePath, extractQuickReference, getXanoscriptDocsVersion, getTopicNames as getXanoscriptTopicNames, getTopicDescriptions as getXanoscriptTopicDescriptions, } from "./xanoscript.js";
+// =============================================================================
+// MCP Tool Definitions (for building custom MCP servers)
+// =============================================================================
+export { toolDefinitions, handleTool, validateXanoscriptToolDefinition, xanoscriptDocsToolDefinition, mcpVersionToolDefinition, metaApiDocsToolDefinition, runApiDocsToolDefinition, cliDocsToolDefinition, } from "./tools/index.js";

package/dist/tools/cli_docs.d.ts

@@ -0,0 +1,40 @@
+/**
+ * CLI Documentation Tool
+ *
+ * Retrieves documentation for the Xano CLI.
+ * Re-exports from the cli_docs module with ToolResult support.
+ */
+import { cliDocsToolDefinition, topics, getTopicNames, getTopicDescriptions } from "../cli_docs/index.js";
+import type { CliDocsArgs, DetailLevel, TopicDoc } from "../cli_docs/types.js";
+import type { ToolResult } from "./types.js";
+export { cliDocsToolDefinition, topics as cliTopics, getTopicNames as getCliTopicNames, getTopicDescriptions as getCliTopicDescriptions, };
+export type { CliDocsArgs, DetailLevel, TopicDoc };
+export interface CliDocsResult {
+    documentation: string;
+}
+/**
+ * Get Xano CLI documentation.
+ *
+ * @param args - Documentation arguments
+ * @returns Documentation content
+ *
+ * @example
+ * ```ts
+ * import { cliDocs } from '@xano/developer-mcp';
+ *
+ * // Get overview
+ * const overview = cliDocs({ topic: 'start' });
+ *
+ * // Get function documentation with examples
+ * const functionDocs = cliDocs({
+ *   topic: 'function',
+ *   detail_level: 'examples'
+ * });
+ * ```
+ */
+export declare function cliDocs(args: CliDocsArgs): CliDocsResult;
+/**
+ * Get CLI documentation and return a ToolResult.
+ */
+export declare function cliDocsTool(args: CliDocsArgs): ToolResult;
+export { cliDocsToolDefinition as toolDefinition };

package/dist/tools/cli_docs.js

@@ -0,0 +1,68 @@
+/**
+ * CLI Documentation Tool
+ *
+ * Retrieves documentation for the Xano CLI.
+ * Re-exports from the cli_docs module with ToolResult support.
+ */
+import { handleCliDocs as _handleCliDocs, cliDocsToolDefinition, topics, getTopicNames, getTopicDescriptions, } from "../cli_docs/index.js";
+// =============================================================================
+// Re-exports
+// =============================================================================
+export { cliDocsToolDefinition, topics as cliTopics, getTopicNames as getCliTopicNames, getTopicDescriptions as getCliTopicDescriptions, };
+// =============================================================================
+// Standalone Tool Function
+// =============================================================================
+/**
+ * Get Xano CLI documentation.
+ *
+ * @param args - Documentation arguments
+ * @returns Documentation content
+ *
+ * @example
+ * ```ts
+ * import { cliDocs } from '@xano/developer-mcp';
+ *
+ * // Get overview
+ * const overview = cliDocs({ topic: 'start' });
+ *
+ * // Get function documentation with examples
+ * const functionDocs = cliDocs({
+ *   topic: 'function',
+ *   detail_level: 'examples'
+ * });
+ * ```
+ */
+export function cliDocs(args) {
+    if (!args?.topic) {
+        throw new Error("'topic' parameter is required. Use topic='start' for overview.");
+    }
+    const documentation = _handleCliDocs(args);
+    return { documentation };
+}
+/**
+ * Get CLI documentation and return a ToolResult.
+ */
+export function cliDocsTool(args) {
+    if (!args?.topic) {
+        return {
+            success: false,
+            error: "Error: 'topic' parameter is required. Use cli_docs with topic='start' for overview.",
+        };
+    }
+    try {
+        const result = cliDocs(args);
+        return {
+            success: true,
+            data: result.documentation,
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            success: false,
+            error: `Error retrieving CLI documentation: ${errorMessage}`,
+        };
+    }
+}
+// Re-export tool definition for MCP
+export { cliDocsToolDefinition as toolDefinition };

package/dist/tools/index.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Xano Developer MCP Tools
+ *
+ * This module exports all tools for both MCP server usage and standalone library usage.
+ *
+ * @example MCP Server Usage (internal)
+ * ```ts
+ * import { toolDefinitions, handleTool } from './tools/index.js';
+ *
+ * // Register tools with MCP server
+ * server.setRequestHandler(ListToolsRequestSchema, () => ({
+ *   tools: toolDefinitions
+ * }));
+ * ```
+ *
+ * @example Library Usage (external)
+ * ```ts
+ * import {
+ *   validateXanoscript,
+ *   xanoscriptDocs,
+ *   metaApiDocs,
+ *   runApiDocs,
+ *   cliDocs,
+ *   mcpVersion
+ * } from '@xano/developer-mcp';
+ *
+ * // Use tools directly
+ * const result = validateXanoscript({ code: 'return 1 + 1' });
+ * const docs = xanoscriptDocs({ topic: 'syntax' });
+ * ```
+ */
+import { validateXanoscript, validateXanoscriptTool, validateXanoscriptToolDefinition, type ValidateXanoscriptArgs, type ValidationResult, type ParserDiagnostic } from "./validate_xanoscript.js";
+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 ValidateXanoscriptArgs, type ValidationResult, 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, };
+/**
+ * All tool definitions for MCP server registration
+ */
+export declare const toolDefinitions: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            code: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {};
+        required: never[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            topic: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            detail_level: {
+                type: string;
+                enum: string[];
+                default: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+})[];
+/**
+ * Handle a tool call by name and return the result.
+ * This is used by the MCP server to dispatch tool calls.
+ */
+export declare function handleTool(name: string, args: Record<string, unknown>): ToolResult;

package/dist/tools/index.js

@@ -0,0 +1,104 @@
+/**
+ * Xano Developer MCP Tools
+ *
+ * This module exports all tools for both MCP server usage and standalone library usage.
+ *
+ * @example MCP Server Usage (internal)
+ * ```ts
+ * import { toolDefinitions, handleTool } from './tools/index.js';
+ *
+ * // Register tools with MCP server
+ * server.setRequestHandler(ListToolsRequestSchema, () => ({
+ *   tools: toolDefinitions
+ * }));
+ * ```
+ *
+ * @example Library Usage (external)
+ * ```ts
+ * import {
+ *   validateXanoscript,
+ *   xanoscriptDocs,
+ *   metaApiDocs,
+ *   runApiDocs,
+ *   cliDocs,
+ *   mcpVersion
+ * } from '@xano/developer-mcp';
+ *
+ * // Use tools directly
+ * const result = validateXanoscript({ code: 'return 1 + 1' });
+ * const docs = xanoscriptDocs({ topic: 'syntax' });
+ * ```
+ */
+// =============================================================================
+// Tool Imports
+// =============================================================================
+import { validateXanoscript, validateXanoscriptTool, validateXanoscriptToolDefinition, } from "./validate_xanoscript.js";
+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";
+// =============================================================================
+// Standalone Tool Functions (for library usage)
+// =============================================================================
+export { 
+// Validation
+validateXanoscript, 
+// XanoScript Documentation
+xanoscriptDocs, getXanoscriptDocsPath, setXanoscriptDocsPath, 
+// MCP Version
+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, };
+// =============================================================================
+// MCP Tool Definitions
+// =============================================================================
+export { validateXanoscriptToolDefinition, xanoscriptDocsToolDefinition, mcpVersionToolDefinition, metaApiDocsToolDefinition, runApiDocsToolDefinition, cliDocsToolDefinition, };
+/**
+ * All tool definitions for MCP server registration
+ */
+export const toolDefinitions = [
+    validateXanoscriptToolDefinition,
+    xanoscriptDocsToolDefinition,
+    mcpVersionToolDefinition,
+    metaApiDocsToolDefinition,
+    runApiDocsToolDefinition,
+    cliDocsToolDefinition,
+];
+// =============================================================================
+// Tool Handler (for MCP server)
+// =============================================================================
+/**
+ * Handle a tool call by name and return the result.
+ * This is used by the MCP server to dispatch tool calls.
+ */
+export function handleTool(name, args) {
+    switch (name) {
+        case "validate_xanoscript":
+            return validateXanoscriptTool(args);
+        case "xanoscript_docs":
+            return xanoscriptDocsTool(args);
+        case "mcp_version":
+            return mcpVersionTool();
+        case "meta_api_docs":
+            return metaApiDocsTool(args);
+        case "run_api_docs":
+            return runApiDocsTool(args);
+        case "cli_docs":
+            return cliDocsTool(args);
+        default:
+            return {
+                success: false,
+                error: `Unknown tool: ${name}`,
+            };
+    }
+}

package/dist/tools/mcp_version.d.ts

@@ -0,0 +1,45 @@
+/**
+ * MCP Version Tool
+ *
+ * Returns the current version of the Xano Developer MCP server.
+ * Can be used standalone or within the MCP server.
+ */
+import type { ToolResult } from "./types.js";
+export interface McpVersionResult {
+    version: string;
+}
+/**
+ * Get the MCP server version from package.json.
+ */
+export declare function getServerVersion(): string;
+/**
+ * Set a custom version (useful for testing)
+ */
+export declare function setServerVersion(version: string): void;
+/**
+ * Get the MCP server version.
+ *
+ * @returns Version information
+ *
+ * @example
+ * ```ts
+ * import { mcpVersion } from '@xano/developer-mcp';
+ *
+ * const { version } = mcpVersion();
+ * console.log(`Running version ${version}`);
+ * ```
+ */
+export declare function mcpVersion(): McpVersionResult;
+/**
+ * Get the MCP version and return a ToolResult.
+ */
+export declare function mcpVersionTool(): ToolResult;
+export declare const mcpVersionToolDefinition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {};
+        required: never[];
+    };
+};

package/dist/tools/mcp_version.js

@@ -0,0 +1,94 @@
+/**
+ * MCP Version Tool
+ *
+ * Returns the current version of the Xano Developer MCP server.
+ * Can be used standalone or within the MCP server.
+ */
+import { readFileSync } from "fs";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+// =============================================================================
+// Version Resolution
+// =============================================================================
+let _version = null;
+/**
+ * Get the MCP server version from package.json.
+ */
+export function getServerVersion() {
+    if (_version !== null)
+        return _version;
+    try {
+        const __filename = fileURLToPath(import.meta.url);
+        const __dirname = dirname(__filename);
+        // Try multiple paths for package.json
+        const possiblePaths = [
+            join(__dirname, "..", "..", "package.json"), // dist/tools -> root
+            join(__dirname, "..", "..", "..", "package.json"), // src/tools -> root
+        ];
+        for (const p of possiblePaths) {
+            try {
+                const pkg = JSON.parse(readFileSync(p, "utf-8"));
+                if (pkg.version) {
+                    const version = pkg.version;
+                    _version = version;
+                    return version;
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+    }
+    catch {
+        // Fallback
+    }
+    _version = "unknown";
+    return "unknown";
+}
+/**
+ * Set a custom version (useful for testing)
+ */
+export function setServerVersion(version) {
+    _version = version;
+}
+// =============================================================================
+// Standalone Tool Function
+// =============================================================================
+/**
+ * Get the MCP server version.
+ *
+ * @returns Version information
+ *
+ * @example
+ * ```ts
+ * import { mcpVersion } from '@xano/developer-mcp';
+ *
+ * const { version } = mcpVersion();
+ * console.log(`Running version ${version}`);
+ * ```
+ */
+export function mcpVersion() {
+    return { version: getServerVersion() };
+}
+/**
+ * Get the MCP version and return a ToolResult.
+ */
+export function mcpVersionTool() {
+    return {
+        success: true,
+        data: getServerVersion(),
+    };
+}
+// =============================================================================
+// MCP Tool Definition
+// =============================================================================
+export const mcpVersionToolDefinition = {
+    name: "mcp_version",
+    description: "Get the current version of the Xano Developer MCP server. " +
+        "Returns the version string from package.json.",
+    inputSchema: {
+        type: "object",
+        properties: {},
+        required: [],
+    },
+};

package/dist/tools/meta_api_docs.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Meta API Documentation Tool
+ *
+ * Retrieves documentation for Xano's Meta API.
+ * Re-exports from the meta_api_docs module with ToolResult support.
+ */
+import { metaApiDocsToolDefinition, topics, getTopicNames, getTopicDescriptions } from "../meta_api_docs/index.js";
+import type { MetaApiDocsArgs, DetailLevel, TopicDoc } from "../meta_api_docs/types.js";
+import type { ToolResult } from "./types.js";
+export { metaApiDocsToolDefinition, topics as metaApiTopics, getTopicNames as getMetaApiTopicNames, getTopicDescriptions as getMetaApiTopicDescriptions, };
+export type { MetaApiDocsArgs, DetailLevel, TopicDoc };
+export interface MetaApiDocsResult {
+    documentation: string;
+}
+/**
+ * Get Xano Meta API documentation.
+ *
+ * @param args - Documentation arguments
+ * @returns Documentation content
+ *
+ * @example
+ * ```ts
+ * import { metaApiDocs } from '@xano/developer-mcp';
+ *
+ * // Get overview
+ * const overview = metaApiDocs({ topic: 'start' });
+ *
+ * // Get workspace documentation with examples
+ * const workspaceDocs = metaApiDocs({
+ *   topic: 'workspace',
+ *   detail_level: 'examples',
+ *   include_schemas: true
+ * });
+ * ```
+ */
+export declare function metaApiDocs(args: MetaApiDocsArgs): MetaApiDocsResult;
+/**
+ * Get Meta API documentation and return a ToolResult.
+ */
+export declare function metaApiDocsTool(args: MetaApiDocsArgs): ToolResult;
+export { metaApiDocsToolDefinition as toolDefinition };

package/dist/tools/meta_api_docs.js

@@ -0,0 +1,69 @@
+/**
+ * Meta API Documentation Tool
+ *
+ * Retrieves documentation for Xano's Meta API.
+ * Re-exports from the meta_api_docs module with ToolResult support.
+ */
+import { handleMetaApiDocs as _handleMetaApiDocs, metaApiDocsToolDefinition, topics, getTopicNames, getTopicDescriptions, } from "../meta_api_docs/index.js";
+// =============================================================================
+// Re-exports
+// =============================================================================
+export { metaApiDocsToolDefinition, topics as metaApiTopics, getTopicNames as getMetaApiTopicNames, getTopicDescriptions as getMetaApiTopicDescriptions, };
+// =============================================================================
+// Standalone Tool Function
+// =============================================================================
+/**
+ * Get Xano Meta API documentation.
+ *
+ * @param args - Documentation arguments
+ * @returns Documentation content
+ *
+ * @example
+ * ```ts
+ * import { metaApiDocs } from '@xano/developer-mcp';
+ *
+ * // Get overview
+ * const overview = metaApiDocs({ topic: 'start' });
+ *
+ * // Get workspace documentation with examples
+ * const workspaceDocs = metaApiDocs({
+ *   topic: 'workspace',
+ *   detail_level: 'examples',
+ *   include_schemas: true
+ * });
+ * ```
+ */
+export function metaApiDocs(args) {
+    if (!args?.topic) {
+        throw new Error("'topic' parameter is required. Use topic='start' for overview.");
+    }
+    const documentation = _handleMetaApiDocs(args);
+    return { documentation };
+}
+/**
+ * Get Meta API documentation and return a ToolResult.
+ */
+export function metaApiDocsTool(args) {
+    if (!args?.topic) {
+        return {
+            success: false,
+            error: "Error: 'topic' parameter is required. Use meta_api_docs with topic='start' for overview.",
+        };
+    }
+    try {
+        const result = metaApiDocs(args);
+        return {
+            success: true,
+            data: result.documentation,
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            success: false,
+            error: `Error retrieving API documentation: ${errorMessage}`,
+        };
+    }
+}
+// Re-export tool definition for MCP
+export { metaApiDocsToolDefinition as toolDefinition };