Routebase
Design, mock, test and document an OpenAPI spec through a built-in agent server
- 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-mcpAdd 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)RequiredROUTEBASE_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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools