unorouter-mcp
MCP serverSearchThis integration connects your AI to the UnoRouter model catalog, so it can find models, check what they cost, and send prompts through a single key. Once added, your AI can search over 200 models, spot the ones that cost nothing, and chat with any model you pick.
Use unorouter-mcp in Claude, ChatGPT or Ahel Desktop
Free. Sign in, add unorouter-mcp and connect your AI. About a minute.
Also: Claude Code · Cursor · Codex
Then ask your AI: use unorouter-mcp to search models
No key or account is asked for. Not verified by us yet: Ahel has not run a call through it.
Details
Available today. Use it from your connected AI after setup. It ran on Ahel's own infrastructure and offers 3 tools.
No key or account is asked for. Not verified by us yet: Ahel has not run a call through it.
After adding it, ask your AI to search the model catalog for what you need, then have it send a test prompt to a model that looks like a good fit. Use a pricing lookup to confirm costs before running anything bigger.
What your AI can do with it
- Search the live catalog of 200+ UnoRouter models
- Find models that cost nothing, marked with :free
- Send a single prompt to any UnoRouter model and get the reply
- Look up pricing, listed in USD per million tokens
- Check a model's price before using it
Install unorouter-mcp
The server’s own address, for the clients that take one directly. Or connect Ahel once and every client you use reads it from one address, with the account kept on Ahel rather than in each client’s config.
Claude Code
claude mcp add --transport http --scope user unorouter-mcp 'https://mcp.unorouter.com/mcp'Run it once in your project, then open /mcp to approve any sign-in the server asks for.
Claude Desktop
https://mcp.unorouter.com/mcpAdd a custom connector in Settings, paste this address, and approve the sign-in.
Cursor
cursor://anysphere.cursor-deeplink/mcp/install?name=unorouter-mcp&config=eyJ1cmwiOiJodHRwczovL21jcC51bm9yb3V0ZXIuY29tL21jcCJ9Open the link and Cursor adds the server at that address.
ChatGPT
https://mcp.unorouter.com/mcpIn Settings, enable Developer mode, create an MCP app, and paste this address. Your plan and workspace must allow custom apps.
Codex
codex mcp add unorouter-mcp --url 'https://mcp.unorouter.com/mcp'Run it once, then sign in with codex mcp login unorouter-mcp if the server asks for an account.
From the project's README
As published by 0-don/unorouter-mcp in README.md.
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
Tools it gives your AI (3)
| Tool | What it does |
|---|---|
| search_models | Search the live UnoRouter model catalog (200+ models behind one OpenAI-compatible key). Models ending in :free cost nothing. |
| chat | Send a single prompt to any UnoRouter model and return the reply. Use search_models to find model IDs; :free models cost nothing (light per-model rate limit, rotate models if you hit 429). |
| get_pricing | Look up per-token pricing for UnoRouter models from the public pricing endpoint. Prices are USD list prices per 1M tokens before per-group discounts (the account dashboard shows the exact effective... |
Signals
- Last commit
- Sep 2026
- Weekly downloads
- 252
- Weekly_downloads
- 36 weekly_downloads
- Tools captured
- 3
Advanced
- Delivery
- mcp MCP server → your Ahel connector (mcp.ahel.ai) → your AI.
- Item type
- mcp-server
- Key
com-unorouter-mcp- Source
- github.com/0-don/unorouter-mcp
- Hosted endpoint
https://mcp.unorouter.com/mcp
github.com/0-don/unorouter-mcp