About unorouter
unorouter-mcp gives MCP clients access to UnoRouter's model catalog, pricing lookup, and chat, for users who want to call multiple models with one API key. It searches more than 200 models and returns chat replies with token usage.
Key features
- 01Filter the live model catalog
- 02Look up prices per million tokens
- 03Send chat requests to selected models
- 04Return replies and token usage
Use cases
- 01Find models matching filters or marked free
- 02Compare listed model prices
- 03Send prompts to models using one API key
MCP support
The MCP server provides clients with the `search_models`, `get_pricing`, and `chat` tools. Calls to the UnoRouter API require `UNOROUTER_API_KEY`.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://mcp.unorouter.com/mcpclaude mcp add --transport http com-unorouter https://mcp.unorouter.com/mcp{"mcpServers":{"com-unorouter":{"type":"http","url":"https://mcp.unorouter.com/mcp"}}}Open in Cursor{"servers":{"com-unorouter":{"type":"http","url":"https://mcp.unorouter.com/mcp"}}}Open in VS Code{"mcpServers":{"com-unorouter":{"type":"http","url":"https://mcp.unorouter.com/mcp"}}}{"mcpServers":{"com-unorouter":{"serverUrl":"https://mcp.unorouter.com/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
3| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | integer | No | Max results, default 50 |
| query | string | No | Substring filter on the model id, e.g. 'deepseek' or 'claude' |
| free_only | boolean | No | Only return :free models |
Details
From the project READMEunorouter-mcp
MCP server for UnoRouter, an open-source OpenAI-compatible gateway serving 200+ models (Claude, GPT, Gemini, DeepSeek, Kimi, GLM, Qwen and more) behind a single API key. Models with a :free suffix cost nothing.
Gives any MCP client (Claude Desktop, Claude Code, Cursor, Windsurf, and friends) three tools:
search_models: filter the live catalog, optionally free models onlyget_pricing: USD per-1M-token list prices from the public pricing endpointchat: send a prompt to any model and get the reply with token usage
Setup
Create an API key at unorouter.com/token (Discord or GitHub sign-in, no card required).
Claude Desktop / any MCP client
{
"mcpServers": {
"unorouter": {
"command": "npx",
"args": ["-y", "unorouter-mcp"],
"env": {
"UNOROUTER_API_KEY": "sk-your-key"
}
}
}
}
Claude Code
claude mcp add unorouter -e UNOROUTER_API_KEY=sk-your-key -- npx -y unorouter-mcp
Environment
| Variable | Required | Default |
|---|---|---|
UNOROUTER_API_KEY | yes | none |
UNOROUTER_BASE_URL | no | https://api.unorouter.com |
Notes
- Free models run on shared pools with a light per-model rate limit (about 1 request per minute per model); rotate between free models or use paid ones for throughput.
- The whole UnoRouter stack is open source: github.com/unorouter.
Development
bun install
bun run build
UNOROUTER_API_KEY=sk-... node dist/index.js
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.