MCP Server

Automatic Setup (Recommended)

Run the wizard from your terminal:

npx backant@latest

The wizard will log you in via OAuth, detect your installed coding agents, and write the MCP configuration automatically. No manual config needed.

Supports 30+ agents including Claude Code, Cursor, Windsurf, VS Code, Copilot, Cline, and more.

Manual Configuration

Remote Server is recommended — no dependencies, no local process. If remote keeps failing (especially in Claude Code), switch to Local Server.

Local Server requires Docker. Run docker compose up -d in the backant-mcp directory first.

The remote MCP server URL is https://mcp.backant.io/mcp. The local server runs at http://localhost:8000/mcp. Your API key is obtained automatically by the wizard via OAuth. To get one manually, log in at backant.io/dashboard.

Client-Specific Configuration

Claude Code

See Claude Code MCP docs for more info.Remote Server (Recommended):

# Current project only
claude mcp add --transport http --header "Authorization: Bearer YOUR_API_KEY" backant "https://mcp.backant.io/mcp"

# All projects (global)
claude mcp add --transport http --header "Authorization: Bearer YOUR_API_KEY" --scope user backant "https://mcp.backant.io/mcp"

Local Server:

# Current project only
claude mcp add --transport http --header "Authorization: Bearer YOUR_API_KEY" backant "http://localhost:8000/mcp"

# All projects (global)
claude mcp add --transport http --header "Authorization: Bearer YOUR_API_KEY" --scope user backant "http://localhost:8000/mcp"

Scope	Description
`--scope local`	Current project only — stored in `.mcp.json`
`--scope user`	All projects — stored in `~/.claude/settings.json`

Use --scope user to have BackAnt available across all your projects without configuring each one.

Cursor

Go to: Settings → Cursor Settings → MCP → Add new global MCP serverOr manually edit ~/.cursor/mcp.json:

macOS: ~/.cursor/mcp.json
Windows: %APPDATA%\Cursor\mcp.json
Linux: ~/.config/cursor/mcp.json

See Cursor MCP docs for more info.Remote Server (Recommended):

{
  "mcpServers": {
    "backant": {
      "url": "https://mcp.backant.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Local Server:

{
  "mcpServers": {
    "backant": {
      "url": "http://localhost:8000/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

VS Code

Open your VS Code MCP configuration:

Run MCP: Open User Configuration from the Command Palette
Or manually edit:
- macOS/Linux: ~/.config/Code/User/mcp.json
- Windows: %APPDATA%\Code\User\mcp.json

See VS Code MCP docs for more info.Remote Server (Recommended):

"mcp": {
  "servers": {
    "backant": {
      "type": "http",
      "url": "https://mcp.backant.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Local Server:

"mcp": {
  "servers": {
    "backant": {
      "type": "http",
      "url": "http://localhost:8000/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Windsurf

Edit your Windsurf MCP configuration:

macOS: ~/.windsurf/mcp.json
Windows: %APPDATA%\Windsurf\mcp.json
Linux: ~/.config/windsurf/mcp.json

See Windsurf MCP docs for more info.Remote Server (Recommended):

{
  "mcpServers": {
    "backant": {
      "serverUrl": "https://mcp.backant.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Local Server:

{
  "mcpServers": {
    "backant": {
      "serverUrl": "http://localhost:8000/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Cline

Open Cline
Click the hamburger menu → MCP Servers
Choose Remote Servers tab
Click Edit Configuration
Add backant to mcpServers:

Remote Server (Recommended):

{
  "mcpServers": {
    "backant": {
      "url": "https://mcp.backant.io/mcp",
      "type": "streamableHttp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Local Server:

{
  "mcpServers": {
    "backant": {
      "url": "http://localhost:8000/mcp",
      "type": "streamableHttp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Roo Code

See Roo Code MCP docs for more info.Remote Server (Recommended):

{
  "mcpServers": {
    "backant": {
      "type": "streamable-http",
      "url": "https://mcp.backant.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Local Server:

{
  "mcpServers": {
    "backant": {
      "type": "streamable-http",
      "url": "http://localhost:8000/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Continue.dev

Edit your ~/.continue/config.json:Remote Server (Recommended):

{
  "experimental": {
    "modelContextProtocolServer": {
      "transport": {
        "type": "http",
        "url": "https://mcp.backant.io/mcp",
        "headers": {
          "Authorization": "Bearer YOUR_API_KEY"
        }
      }
    }
  }
}

Local Server:

{
  "experimental": {
    "modelContextProtocolServer": {
      "transport": {
        "type": "http",
        "url": "http://localhost:8000/mcp",
        "headers": {
          "Authorization": "Bearer YOUR_API_KEY"
        }
      }
    }
  }
}

Claude Desktop

Edit your Claude Desktop configuration:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Remote Server (Recommended):Navigate to Settings → Connectors → Add Custom Connector. Enter the name backant and the URL https://mcp.backant.io/mcp.Local Server:

{
  "mcpServers": {
    "backant": {
      "url": "http://localhost:8000/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Copilot (VS Code)

Add to your VS Code MCP configuration — Run MCP: Open User Configuration from the Command Palette.Remote Server (Recommended):

{
  "mcpServers": {
    "backant": {
      "type": "http",
      "url": "https://mcp.backant.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Kilo Code

Create .kilocode/mcp.json in your project:Remote Server (Recommended):

{
  "mcpServers": {
    "backant": {
      "type": "streamable-http",
      "url": "https://mcp.backant.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      },
      "disabled": false
    }
  }
}

Local Server:

{
  "mcpServers": {
    "backant": {
      "type": "streamable-http",
      "url": "http://localhost:8000/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      },
      "disabled": false
    }
  }
}

JetBrains AI Assistant

Go to Settings → Tools → AI Assistant → Model Context Protocol (MCP)
Click + Add
Select As JSON
Add configuration:

{
  "mcpServers": {
    "backant": {
      "url": "https://mcp.backant.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Click Apply

Zed

Add to your Zed settings.json. See Zed Context Server docs for more info.

{
  "context_servers": {
    "backant": {
      "source": "custom",
      "url": "https://mcp.backant.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Warp

Navigate to Settings → AI → Manage MCP servers → + Add:

{
  "backant": {
    "url": "https://mcp.backant.io/mcp",
    "headers": {
      "Authorization": "Bearer YOUR_API_KEY"
    },
    "start_on_launch": true
  }
}

Amazon Q Developer CLI

See Amazon Q Developer CLI docs for more details.

{
  "mcpServers": {
    "backant": {
      "url": "https://mcp.backant.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Gemini CLI

Open ~/.gemini/settings.json and add:

{
  "mcpServers": {
    "backant": {
      "httpUrl": "https://mcp.backant.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY",
        "Accept": "application/json, text/event-stream"
      }
    }
  }
}

Opencode

{
  "mcp": {
    "backant": {
      "type": "remote",
      "url": "https://mcp.backant.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      },
      "enabled": true
    }
  }
}

Augment Code

Via UI: Hamburger menu → Settings → Tools → + Add MCPOr manually in settings:

"augment.advanced": {
  "mcpServers": [
    {
      "name": "backant",
      "url": "https://mcp.backant.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  ]
}

Qodo Gen

Open the Qodo Gen chat panel
Click Connect more tools → + Add new MCP

{
  "mcpServers": {
    "backant": {
      "url": "https://mcp.backant.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Trae

{
  "mcpServers": {
    "backant": {
      "url": "https://mcp.backant.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Amp

amp mcp add backant --header "Authorization=Bearer YOUR_API_KEY" https://mcp.backant.io/mcp

Factory

droid mcp add backant https://mcp.backant.io/mcp --type http --header "Authorization: Bearer YOUR_API_KEY"

Crush

{
  "mcp": {
    "backant": {
      "type": "http",
      "url": "https://mcp.backant.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Visual Studio 2022

{
  "servers": {
    "backant": {
      "type": "http",
      "url": "https://mcp.backant.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

LM Studio

Go to Program → Install → Edit mcp.json:

{
  "mcpServers": {
    "backant": {
      "url": "https://mcp.backant.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

BoltAI

Open Settings → Plugins:

{
  "mcpServers": {
    "backant": {
      "url": "https://mcp.backant.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Perplexity Desktop

Navigate to Settings → Connectors → Add Connector → Advanced
Server Name: backant
Add:

{
  "url": "https://mcp.backant.io/mcp",
  "headers": {
    "Authorization": "Bearer YOUR_API_KEY"
  }
}

OpenAI Codex

[mcp_servers.backant]
url = "https://mcp.backant.io/mcp"
http_headers = { "Authorization" = "Bearer YOUR_API_KEY" }

Kiro

{
  "mcpServers": {
    "backant": {
      "url": "https://mcp.backant.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      },
      "disabled": false
    }
  }
}

Local Server Setup

To run the BackAnt MCP server locally:

git clone https://github.com/backant/backant-mcp
cd backant-mcp
docker compose up -d

Verify it is running:

curl http://localhost:8000/health
# {"status": "ok"}

Then use http://localhost:8000/mcp in place of the remote URL in any config above.

Available MCP Tools

Once connected, your agent has access to:

Tool	Description
`generate_api`	Scaffold a new BackAnt Flask API project
`generate_route`	Add a route (+ service, repository, model) to an existing project
`generate_subroute`	Add a subroute endpoint to an existing route
`analyze_project`	Inspect the structure of an existing BackAnt project
`validate_spec`	Validate a JSON spec without generating any files
`get_project_info`	Get metadata (routes, models, docker presence) about a project
`check_route_exists`	Check whether a specific route has been generated

​Automatic Setup (Recommended)

​Manual Configuration

​Client-Specific Configuration

​Available MCP Tools

Automatic Setup (Recommended)

Manual Configuration

Client-Specific Configuration

Available MCP Tools