routebase-mcp

routebase-mcp

Connect your AI agent to your Routebase APIs. This is the Model Context Protocol server for Routebase — it lets agents like Claude Code, Cursor, and VS Code read and work with your API specs, endpoints, schemas, tests, and mock servers over stdio.

Quick start

You don't need to install anything globally — npx runs it on demand:

ROUTEBASE_API_KEY=rb_… npx routebase-mcp

Generate an API key in Routebase under Settings → API Keys.

Configure your client

The interactive setup writes the right config for you:

npx routebase-mcp init

Or add it manually. All clients use the same shape:

Claude Code (~/.claude.json or project .mcp.json):

{
  "mcpServers": {
    "routebase": {
      "command": "npx",
      "args": ["-y", "routebase-mcp", "--stdio"],
      "env": {
        "ROUTEBASE_API_KEY": "rb_…"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json or .cursor/mcp.json) and VS Code (.vscode/mcp.json) use the identical block.

Configuration

Environment variable	Required	Description
ROUTEBASE_API_KEY	✅	API key for authentication. Create one under Settings → API Keys.
ROUTEBASE_REGION	US accounts	Home region of your account: us or eu (default: eu). Without it, a US key fails as if it were invalid. npx routebase-mcp init asks for the region (or takes --region us) and writes it into the config for you.
ROUTEBASE_LOG_LEVEL	–	verbose · debug · info · warning · error · fatal (default: warning). Logs go to stderr — stdout is reserved for the MCP protocol.

How it works

This npm package is a tiny shim. On first run it downloads the self-contained CLI binary for your platform from releases.routebase.dev, verifies it against a SHA-256 checksum baked into this package at publish time (it refuses to run on mismatch — fail-closed), and caches it under ~/.routebase/bin/<version>/. Subsequent runs use the cached binary.

Supported platforms: macOS (arm64, x64), Windows (x64), Linux (x64). Requires Node.js ≥ 18.

Links

• 🌐 Routebase: https://routebase.dev

License

The npm shim in this package is MIT. The downloaded Routebase CLI binary is governed by the Routebase Terms.