@howells/routerbase-mcp

MCP server for the Routerbase AI model catalog. Gives AI agents 5 read-only tools to query and compare 500+ models by quality, cost, speed, and capabilities.

Tools

| Tool | Use when | |------|----------| | list_models | Selecting a model for a task — filter by capability, cost, quality, context, provider | | get_model | Looking up a specific model by OpenRouter ID or name | | find_models_by_capability | Finding models that support specific capabilities (vision, tool-calling, etc.) | | get_cheapest_models | Cost-minimisation — find the cheapest models meeting a quality floor | | compare_models | Evaluating 2–5 specific candidates side by side |

Usage with Claude Code

Add to .mcp.json in your project root:

{
  "mcpServers": {
    "routerbase": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@howells/routerbase-mcp"]
    }
  }
}

Usage with other MCP clients

npx -y @howells/routerbase-mcp

The server communicates over stdio. Point any MCP-compatible client at this command.

Environment variables

| Variable | Default | Description | |----------|---------|-------------| | ROUTERBASE_API_URL | https://routerbase.dev | Override the API base URL (useful for local dev) |

Data

All data is sourced from routerbase.dev/api/models — a public, CORS-open REST API. Models are synced from OpenRouter, quality scores from LMSYS Arena ELO, and speed data from Artificial Analysis.

License

MIT