Skip to content
MCP server

Routebase

Design, mock, test and document an OpenAPI spec through a built-in agent server

Install
Pricing
Freemium
Platforms
Web, API, CLI
Runs
Locally or Remotely
Version
1.1.4
Listing updated
2 days ago

About Routebase

Routebase is a freemium MCP server for developer tools. It can run locally on your machine or as a hosted remote server.

Every Routebase workspace includes this server, and an agent acts on the same OpenAPI spec as your team under the same role permissions, checked once when tools are listed and again when one is called. Work lands as real objects such as endpoints, schemas, mock rules, test suites and runs, and can arrive as a merge request from a spec branch rather than as a chat transcript.

Two prompts carry the main flow: design_api builds a contract call by call, loading your style guide first, and generate_tests writes happy-path, 400, 401, 403, 404, schema, latency and edge-case checks. The server also ships 12 read-only resources and 13 prompts, and a session starts with five core toolsets, adding more through enable_toolset, to keep the context window light. Specs stay drafts until publish_version freezes an immutable snapshot.

Authentication is OAuth 2.1 or a scoped API key, with a limit of 200 requests per minute per user and a choice of EU or US region. Billing and organisation access are read-only over MCP. On the Free plan the built-in MCP server is read-only.

Install

Run in a terminal

claude mcp add routebase --env ROUTEBASE_API_KEY='<ROUTEBASE_API_KEY>' -- npx -y routebase-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "routebase": {
      "command": "npx",
      "args": [
        "-y",
        "routebase-mcp"
      ],
      "env": {
        "ROUTEBASE_API_KEY": "<ROUTEBASE_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "routebase": {
      "command": "npx",
      "args": [
        "-y",
        "routebase-mcp"
      ],
      "env": {
        "ROUTEBASE_API_KEY": "<ROUTEBASE_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "routebase": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "routebase-mcp"
      ],
      "env": {
        "ROUTEBASE_API_KEY": "<ROUTEBASE_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "routebase": {
      "command": "npx",
      "args": [
        "-y",
        "routebase-mcp"
      ],
      "env": {
        "ROUTEBASE_API_KEY": "<ROUTEBASE_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "routebase": {
      "command": "npx",
      "args": [
        "-y",
        "routebase-mcp"
      ],
      "env": {
        "ROUTEBASE_API_KEY": "<ROUTEBASE_API_KEY>"
      }
    }
  }
}

Configuration

  • ROUTEBASE_API_KEYRoutebase API key (Settings -> API Keys)Required
  • ROUTEBASE_REGIONHome region of the account: eu (default) or us

Tools this server provides (10)

Taken from the project documentation; the running server may differ.

create_spec
Create an API spec.
create_schema
Create a schema.
create_endpoint
Create an endpoint.
add_response
Add a response to an endpoint.
validate_spec
Validate a spec, with a dry-run mode.
run_test_suite
Run a test suite and report failures.
publish_version
Freeze an immutable OpenAPI snapshot.
generate_rules_from_spec
Create mock rules from a spec.
generate_monitors_from_spec
Create monitors from a spec.
enable_toolset
Add a toolset mid-session.

What it does

Spec design by prompt
Creates specs, schemas, endpoints and responses and validates them, with a dry-run mode.
Generated test suites
Produces and runs suites, reporting which assertion failed on which case.
Mocks and monitors from specs
Turns new endpoints into a running mock and puts the contract under monitoring.
Lean sessions
Starts with five core toolsets and enables more on demand.
Permission-aware agents
Agents see only tools their role allows, and billing stays read-only.
Draft-first publishing
Work stays a draft until someone publishes an immutable version.

Good for

  • Draft a new API contract from a description
  • Generate and run a test suite against a spec
  • Create a mock server from newly added endpoints
  • Review a spec against the organisation style guide
  • Triage security findings or test failures from an editor

Pricing

Freemium

Free plan (MCP read-only); paid per-user plans; 14-day Pro trial, no card

Prices change. Check routebase.dev before you buy.

Routebase FAQ

Do I need an API key?

Not with Claude: add the remote connector and sign in with OAuth. Claude Code, Cursor and VS Code use a scoped API key.

Can an agent publish changes without review?

Specs stay drafts until someone publishes a version, and agent work can arrive as a merge request on a spec branch.

Where is data stored?

In the EU or US region your organisation chose.

What does it cost?

There is a Free plan with read-only MCP, and paid plans priced per user per month, with a 14-day Pro trial and no card.

Is Routebase free?

Routebase has a free plan, with paid plans for more usage or features.

How do I add Routebase to Claude Code?

Run this command in your terminal: claude mcp add routebase --env ROUTEBASE_API_KEY='<ROUTEBASE_API_KEY>' -- npx -y routebase-mcp

What are the best alternatives to Routebase?

The closest alternatives to Routebase are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Routebase

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools