> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xano.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Developer MCP

> Install and configure the Xano Developer MCP for AI-assisted XanoScript development

export const BrowserFrame = props => {
  const {url = "xano.run", maxWidth = 820, className = "", lightSrc, darkSrc, alt = "", children} = props || ({});
  const style = typeof maxWidth === "number" ? {
    maxWidth: `${maxWidth}px`,
    margin: "16px 0"
  } : {
    maxWidth,
    margin: "16px 0"
  };
  const hasSwapImages = Boolean(lightSrc && darkSrc);
  return <div className={`browser-frame ${className}`.trim()} style={style}>
      <div className="browser-frame__top">
        <div className="browser-frame__controls" aria-hidden="true">
          <span className="browser-frame__dot browser-frame__dot--red" />
          <span className="browser-frame__dot browser-frame__dot--yellow" />
          <span className="browser-frame__dot browser-frame__dot--green" />
        </div>
        <div className="browser-frame__address">{url}</div>
      </div>

      <div className="browser-frame__body">
        {hasSwapImages ? <>
            <img className="browser-frame__img--light" src={lightSrc} alt={alt} />
            <img className="browser-frame__img--dark" src={darkSrc} alt={alt} />
          </> : children}
      </div>
    </div>;
};

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.

<Info>
  **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
</Info>

***

## Pick Your Client

The Developer MCP requires [Node.js](https://nodejs.org/) 18 or later. Choose your AI client below for installation and usage instructions.

<CardGroup cols={3}>
  <Card title="Claude Code" icon="https://mintcdn.com/xano-997cb9ee/aZQYcxhIvSDTNEim/images/icons/claude-ai-icon.svg?fit=max&auto=format&n=aZQYcxhIvSDTNEim&q=85&s=b9de3a97860e4296c6d48664852a8e16" href="/developer-mcp/clients/claude-code" width="256" height="257" data-path="images/icons/claude-ai-icon.svg" />

  <Card title="Claude Desktop" icon="https://mintcdn.com/xano-997cb9ee/aZQYcxhIvSDTNEim/images/icons/claude-ai-icon.svg?fit=max&auto=format&n=aZQYcxhIvSDTNEim&q=85&s=b9de3a97860e4296c6d48664852a8e16" href="/developer-mcp/clients/claude-desktop" width="256" height="257" data-path="images/icons/claude-ai-icon.svg" />

  <Card title="VS Code" icon="https://mintcdn.com/xano-997cb9ee/aZQYcxhIvSDTNEim/images/icons/vscode.svg?fit=max&auto=format&n=aZQYcxhIvSDTNEim&q=85&s=bb6c91058fcbe6ee28fcda04e03de2e6" href="/developer-mcp/clients/vs-code" width="100" height="100" data-path="images/icons/vscode.svg" />

  <Card title="Cursor" icon="https://mintcdn.com/xano-997cb9ee/aZQYcxhIvSDTNEim/images/icons/Cursor_light.svg?fit=max&auto=format&n=aZQYcxhIvSDTNEim&q=85&s=c42cd27f6fa1b802cadd5a3514d7ff46" href="/developer-mcp/clients/cursor" width="467" height="532" data-path="images/icons/Cursor_light.svg" />

  <Card title="Windsurf" icon="https://mintcdn.com/xano-997cb9ee/aZQYcxhIvSDTNEim/images/icons/Windsurf_light.svg?fit=max&auto=format&n=aZQYcxhIvSDTNEim&q=85&s=ad7fc1569a810d534939040c60c6cc78" href="/developer-mcp/clients/windsurf" width="1024" height="1024" data-path="images/icons/Windsurf_light.svg" />

  <Card title="Codex" icon="https://mintcdn.com/xano-997cb9ee/aZQYcxhIvSDTNEim/images/icons/OpenAI_light.svg?fit=max&auto=format&n=aZQYcxhIvSDTNEim&q=85&s=8c4486c571ab4c35fe7843ed31718c04" href="/developer-mcp/clients/codex" width="256" height="260" data-path="images/icons/OpenAI_light.svg" />

  <Card title="Gemini CLI" icon="https://mintcdn.com/xano-997cb9ee/iFWc-RFvMkYTid3P/images/icons/gemini.svg?fit=max&auto=format&n=iFWc-RFvMkYTid3P&q=85&s=b1868b87c460669c476c1d136ef95ebe" href="/developer-mcp/clients/gemini-cli" width="24" height="24" data-path="images/icons/gemini.svg" />
</CardGroup>

<Note>
  Don't see your client? The Developer MCP works with any [MCP-compatible client](https://modelcontextprotocol.io/clients). The general pattern is to register `npx -y @xano/developer-mcp` as a stdio server — see any of the pages above for reference.
</Note>

### Global npm Install

If you prefer a global install instead of `npx`:

<BrowserFrame url="Terminal">
  ```bash theme={null}
  npm install -g @xano/developer-mcp
  ```
</BrowserFrame>

Then reference the command directly in your MCP client configuration:

```json theme={null}
{
  "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.

| Skill                    | Description                                                                                   |
| ------------------------ | --------------------------------------------------------------------------------------------- |
| `xano-init`              | Guided setup that profiles a Xano workspace and builds a sandbox-first development playbook   |
| `xanoscript-docs-expert` | Deep 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

<BrowserFrame url="Terminal">
  ```bash theme={null}
  npx skills add xano-inc/xano-developer-mcp -s xano-init -a claude-code -g
  ```
</BrowserFrame>

### Install across multiple agents

Install the same skill into several agents at once:

<BrowserFrame url="Terminal">
  ```bash theme={null}
  npx skills add xano-inc/xano-developer-mcp -s xano-init \
    -a claude-code -a codex -a cursor -a opencode -g
  ```
</BrowserFrame>

Other supported agents include `gemini-cli`, `windsurf`, `continue`, `cline`, and `github-copilot` — see the skills CLI for the full list.

### Flags

| Flag         | Purpose                                                                                              |
| ------------ | ---------------------------------------------------------------------------------------------------- |
| `-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.                                        |
| `-g`         | Install globally (user profile). Drop this flag to scope the install to the current project instead. |

<Note>
  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.
</Note>

***

## 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](/xano-cli/get-started).

<Note>
  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.
</Note>

***

## What's Next

<CardGroup cols={2}>
  <Card title="Tools Reference" icon="wrench" href="/developer-mcp/tools">
    Explore all 6 tools available in the Developer MCP
  </Card>

  <Card title="Resources & Library" icon="book" href="/developer-mcp/resources">
    Access MCP resources and use the package as an npm library
  </Card>
</CardGroup>
