Skip to main content

​
Prerequisites

​
Installation

​
Install the MCP Server

Open Windsurf Settings → Cascade → MCP Servers (or click the settings icon in the top right of the Cascade panel). From there, you’ll need to edit the underlying config file at ~/.codeium/windsurf/mcp_config.json directly: 
{
  "mcpServers": {
    "xano": {
      "command": "npx",
      "args": ["-y", "@xano/developer-mcp"]
    }
  }
}
Save the configuration and restart Windsurf so the new server is registered.

​
Verify Setup

In the Cascade panel, ask:
“What version of the Xano Developer MCP is installed?”
Windsurf should call mcp_version and return the current version number.

​
Install the XanoScript Language Server extension

The language server extension enables code completion and syntax highlighting for XanoScript, and is essential for the best experience. Windsurf uses the Open VSX extension registry — you can install the language server here (or via the VS Code Marketplace here if Windsurf is configured to use it). XanoScript Language Server

​
Usage

The Developer MCP lets Windsurf write and validate XanoScript using your local Xano workspace as context. Before asking Windsurf to make changes, pull a workspace locally with the Xano CLI. If you haven’t installed and authenticated with the CLI yet, do that now before continuing. Then select or create a workspace and run: 
xano workspace pull
Once your workspace is available locally, you can ask Windsurf to help with XanoScript tasks, from building a complete workspace: 
Create a small backend for advisor client intake. It should include a `clients` table with fields for name, email, phone, risk tolerance, investment objective, and advisor notes. Add API endpoints to create a client, list clients, get a single client by ID, and update client details. Include validation for required fields and valid risk tolerance values.
You can also ask it to expand or iterate on existing backends. 
Add a follow-up task feature to the advisor client intake backend. Create a `client_tasks` table linked to clients, with fields for task title, due date, status, and notes. Add API endpoints to create a task for a client, list all tasks for a client, and mark a task as complete.
Once you’re ready, push the changes to your sandbox so you can review them in the browser before promoting to your live workspace: xano sandbox review opens your sandbox in the browser — verify everything looks right, then promote the changes to production from there.

​
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