Skip to main content
Beyond its tools, the Xano Developer MCP also exposes XanoScript documentation as MCP resources for direct access, and can be imported as an npm library for custom integrations.

​
MCP Resources

The server exposes 26 XanoScript documentation files as MCP resources. These can be read directly by URI without calling a tool, which is useful for MCP clients that support resource access.
Resource URIDescription
xanoscript://docs/readmeOverview and quick reference
xanoscript://docs/syntaxExpressions, operators, and filters
xanoscript://docs/typesData types and validation
xanoscript://docs/tablesDatabase schema definitions
xanoscript://docs/functionsReusable function stacks
xanoscript://docs/apisHTTP endpoint definitions
xanoscript://docs/tasksScheduled and cron jobs
xanoscript://docs/triggersEvent-driven handlers
xanoscript://docs/databaseDatabase operations
xanoscript://docs/agentsAI agent configuration
xanoscript://docs/toolsAI tools for agents
xanoscript://docs/mcp-serversMCP server definitions
xanoscript://docs/testingUnit tests and mocks
xanoscript://docs/integrationsExternal service integrations
xanoscript://docs/frontendStatic frontend development
xanoscript://docs/runRun job and service configurations
xanoscript://docs/addonsReusable subqueries for related data
xanoscript://docs/debuggingLogging and debugging tools
xanoscript://docs/performancePerformance optimization
xanoscript://docs/realtimeReal-time channels and events
xanoscript://docs/schemaRuntime schema parsing
xanoscript://docs/securitySecurity best practices
xanoscript://docs/streamingData streaming operations
xanoscript://docs/middlewareRequest/response interceptors
xanoscript://docs/branchBranch-level settings
xanoscript://docs/workspaceWorkspace-level settings

​
npm Library Usage

The @xano/developer-mcp package can also be imported directly as an npm library, allowing you to integrate its capabilities into your own applications or build custom MCP servers.

​
Installation

npm install @xano/developer-mcp

​
Entry Points

The package provides three entry points:
Import PathPurpose
@xano/developer-mcpMain library entry (recommended)
@xano/developer-mcp/toolsTools module directly
@xano/developer-mcp/serverServer module (for extending the MCP server)

​
Core Functions

import {
  validateXanoscript,
  xanoscriptDocs,
  metaApiDocs,
  runApiDocs,
  cliDocs,
  mcpVersion
} from '@xano/developer-mcp';
FunctionDescription
validateXanoscript(args)Validate XanoScript code and get detailed error info
xanoscriptDocs(args)Get XanoScript language documentation
metaApiDocs(args)Get Meta API documentation
runApiDocs(args)Get Run API documentation
cliDocs(args)Get CLI documentation
mcpVersion()Get the package version

​
Building Custom MCP Servers

If you want to build a custom MCP server that includes XanoScript capabilities, you can use the tool definitions and handler: 
import {
  toolDefinitions,
  handleTool,
  toMcpResponse
} from '@xano/developer-mcp';

// toolDefinitions: Array of MCP tool definitions
// handleTool: Dispatches tool calls to the correct handler
// toMcpResponse: Converts a ToolResult to MCP response format

​
Utility Functions

import {
  getDocsForFilePath,
  extractQuickReference,
  getXanoscriptDocsVersion
} from '@xano/developer-mcp';
FunctionDescription
getDocsForFilePath(path)Get matching documentation topics for a file path
extractQuickReference(doc)Extract the Quick Reference section from a doc
getXanoscriptDocsVersion()Get the documentation version from version.json

​
TypeScript Types

All types are exported for TypeScript consumers: 
import type {
  ValidateXanoscriptArgs,
  ValidationResult,
  ParserDiagnostic,
  XanoscriptDocsArgs,
  XanoscriptDocsResult,
  MetaApiDocsArgs,
  MetaApiDocsResult,
  RunApiDocsArgs,
  RunApiDocsResult,
  CliDocsArgs,
  CliDocsResult,
  McpVersionResult,
  ToolResult,
  DocConfig
} from '@xano/developer-mcp';

​
Source Code

The Xano Developer MCP is open source under the MIT license.

GitHub

View the source code and contribute

npm

View the package on npm