# rapidrouter-mcp

An MCP (Model Context Protocol) stdio server for [Rapid Router](https://rapidrouter.ai),
the AI gateway with an OpenAI-compatible API. It lets any MCP client (Claude Desktop,
Claude Code, Cursor, and others) search the live model catalog, look up prices in USD
and INR, send chat completions, and check your credit balance.

## Install

Once published to npm:

```bash
npx rapidrouter-mcp
```

From source, today:

```bash
cd mcp && npm install
node mcp/index.js
```

The server speaks MCP over stdin/stdout. `chat` and `account_balance` need a Rapid Router
API key in the `RAPIDROUTER_API_KEY` environment variable; get one at
<https://rapidrouter.ai/dashboard/keys>. The catalog tools need no key.

## Client configuration

Claude Desktop (`claude_desktop_config.json`) and Cursor (`.cursor/mcp.json`) use the
same `mcpServers` shape:

```json
{
  "mcpServers": {
    "rapidrouter": {
      "command": "npx",
      "args": ["rapidrouter-mcp"],
      "env": { "RAPIDROUTER_API_KEY": "rr-..." }
    }
  }
}
```

Claude Code:

```bash
claude mcp add rapidrouter -e RAPIDROUTER_API_KEY=rr-... -- npx rapidrouter-mcp
```

Running from a checkout instead of npm, replace the command with
`"command": "node", "args": ["/path/to/rapid-router/mcp/index.js"]`.

## Tools

| Tool | Auth | What it does |
| --- | --- | --- |
| `search_models` | none | Search live models by substring on id/name/author, with optional `kind` and `max_price_per_m` (blended USD per 1M tokens) filters. Returns id, provider, context, prices, capabilities. |
| `get_model` | none | One model's full catalog row by exact id, plus INR prices from the catalog's live USD/INR rate. |
| `chat` | `RAPIDROUTER_API_KEY` | Send a prompt (optional `system`, `temperature`, `max_tokens`) to any model; returns the assistant text with usage and billed cost. |
| `account_balance` | `RAPIDROUTER_API_KEY` | Your credit balance in USD and INR. |

Run `rapidrouter-mcp --help` for a usage summary.

## License

MIT