Skip to main content
The Xano Developer MCP (@xano/developer-mcp) is an MCP server that gives AI assistants superpowers for developing on Xano. It provides XanoScript documentation, code validation, and workflow guides directly to your AI tools.
What does it do?The Developer MCP is designed for building with Xano, not managing your Xano instance. It helps AI assistants:
  • Access XanoScript language documentation and syntax references
  • Validate XanoScript code for syntax errors in real-time
  • Retrieve Meta API, Run API, and CLI documentation on demand
  • Provide context-aware docs based on the file you’re editing

​
Installation

The Developer MCP requires Node.js 18 or later. Choose the installation method that matches your MCP client.

​
Claude Code

​
Claude Desktop

Add the following to your Claude Desktop configuration file.
Edit ~/Library/Application Support/Claude/claude_desktop_config.json:
{
  "mcpServers": {
    "xano": {
      "command": "npx",
      "args": ["-y", "@xano/developer-mcp"]
    }
  }
}

​
VS Code

Create or edit .vscode/mcp.json in your project: 
{
  "servers": {
    "xano": {
      "command": "npx",
      "args": ["-y", "@xano/developer-mcp"]
    }
  }
}

​
Cursor

Open Cursor Settings > Tools & Integrations > New MCP Server, and add: 
{
  "xano": {
    "command": "npx",
    "args": ["-y", "@xano/developer-mcp"]
  }
}

​
Windsurf

Open Windsurf Settings > Cascade > Manage Plugins > View Raw Config, and add: 
{
  "xano": {
    "command": "npx",
    "args": ["-y", "@xano/developer-mcp"]
  }
}

​
Codex

Install Codex if you haven’t already: Then add the Xano Developer MCP:

​
Global npm Install

If you prefer a global install instead of npx: Then reference the command directly in your MCP client configuration: 
{
  "xano": {
    "command": "xano-developer-mcp"
  }
}

​
Xano Skills

The Developer MCP repo also ships two agent skills — portable, agent-neutral prompts that give AI assistants deeper Xano expertise on top of what the MCP provides.
SkillDescription
xano-initGuided setup that profiles a Xano workspace and builds a sandbox-first development playbook
xanoscript-docs-expertDeep reference for working with XanoScript documentation and the Developer MCP’s architecture
Skills are distributed via the open Agent Skills standard and install with a single npx command — no cloning or manual file copying.

​
Install a single skill

​
Install across multiple agents

Install the same skill into several agents at once: Other supported agents include gemini-cli, windsurf, continue, cline, and github-copilot — see the skills CLI for the full list.

​
Flags

FlagPurpose
-s <skill>Install a specific skill. Drop this flag to install every skill in the repo.
-a <agent>Target a specific agent. Repeat the flag for multiple agents.
-gInstall globally (user profile). Drop this flag to scope the install to the current project instead.
Start a new agent session after installing so the skill manifest is picked up. Then invoke a skill by name (xano-init, xanoscript-docs-expert) or just describe the task in natural language.

​
No Authentication Required

The Developer MCP runs entirely locally and serves documentation and validation tools. It does not connect to your Xano instance and requires no access tokens or credentials. Connection to your Xano workspace is handled separately by the Xano CLI.
The APIs documented by the meta_api_docs and run_api_docs tools do require authentication when you call them directly. The MCP server itself just provides the documentation.

​
Verify Your Setup

After installation, verify the server is working by asking your AI assistant:
“What version of the Xano Developer MCP is installed?”
The assistant should call mcp_version and return the current version number. You can also try:
“Validate this XanoScript: var $x { value = 1 }”
The assistant should call validate_xanoscript and confirm the code is valid.

​
What’s Next

Tools Reference

Explore all 6 tools available in the Developer MCP

Resources & Library

Access MCP resources and use the package as an npm library