# Routebase

> Routebase is a freemium MCP server for developer tools. Design, mock, test and document an OpenAPI spec through a built-in agent server. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** Web, API, CLI
- **Website:** https://routebase.dev/mcp-server/
- **MCP Registry name:** dev.routebase/routebase
- **Categories:** developer tools
- **Listing updated:** 2026-11-15

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/routebase
