unorouter-mcp

MCP serverSearch

This 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

Details

Available today. Use it from your connected AI after setup. It ran on Ahel's own infrastructure and offers 3 tools.

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.

unorouter-mcpStart free

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/mcp

    Add a custom connector in Settings, paste this address, and approve the sign-in.

  • Cursor

    cursor://anysphere.cursor-deeplink/mcp/install?name=unorouter-mcp&config=eyJ1cmwiOiJodHRwczovL21jcC51bm9yb3V0ZXIuY29tL21jcCJ9

    Open the link and Cursor adds the server at that address.

  • ChatGPT

    https://mcp.unorouter.com/mcp

    In 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 only
  • get_pricing: USD per-1M-token list prices from the public pricing endpoint
  • chat: 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

VariableRequiredDefault
UNOROUTER_API_KEYyesnone
UNOROUTER_BASE_URLnohttps://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)

ToolWhat it does
search_modelsSearch the live UnoRouter model catalog (200+ models behind one OpenAI-compatible key). Models ending in :free cost nothing.
chatSend 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_pricingLook 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