Content
# RouterBase MCP Server
An MCP server for [routerbase](https://routerbase.com), the OpenAI-compatible API gateway for GPT, Claude, Gemini, and 200+ AI models.
This package exposes RouterBase model discovery, model details, pricing lookup, quickstart guidance, and chat completions as Model Context Protocol tools.
## Features
- `routerbase_get_started` returns integration snippets and the canonical [routerbase](https://routerbase.com) link.
- `routerbase_list_models` searches and filters the RouterBase model catalog.
- `routerbase_get_model` fetches details for one model id.
- `routerbase_get_pricing` fetches pricing for one model or all active models.
- `routerbase_chat_completion` calls the OpenAI-compatible `/v1/chat/completions` endpoint.
- `routerbase://overview` is a resource with RouterBase integration metadata.
## Install
```bash
npm install -g routerbase-mcp
```
Or run it without installing:
```bash
npx routerbase-mcp
```
Until the npm package is live, run it directly from GitHub:
```bash
npx -y github:zenlee123/routerbase-mcp
```
## Configuration
Create a RouterBase API key at [routerbase](https://routerbase.com) and set:
```bash
export ROUTERBASE_API_KEY=sk-rb-your-key
```
Optional overrides:
```bash
export ROUTERBASE_API_BASE_URL=https://routerbase.com/api/v1
export ROUTERBASE_OPENAI_BASE_URL=https://routerbase.com/v1
```
## Claude Desktop
```json
{
"mcpServers": {
"routerbase": {
"command": "npx",
"args": ["-y", "routerbase-mcp"],
"env": {
"ROUTERBASE_API_KEY": "sk-rb-your-key"
}
}
}
}
```
## Cursor or other MCP clients
Use the same stdio command:
```json
{
"command": "npx",
"args": ["-y", "routerbase-mcp"],
"env": {
"ROUTERBASE_API_KEY": "sk-rb-your-key"
}
}
```
## Development
```bash
npm install
npm run build
node dist/index.js
```
## Registry Submission
This repository includes:
- `server.json` for the official MCP Registry.
- `metadata/directory-listing.json` for MCP directories.
- `SUBMISSION_KIT.md` with listing copy for MCP.so, PulseMCP, Glama, Smithery, and GitHub lists.
The preferred listing sentence is:
> RouterBase MCP lets AI agents discover models, pricing, and chat completions through [routerbase](https://routerbase.com).
## License
MIT
