# UnoRouter

This MCP server for Claude Code finds UnoRouter models, shows their prices, and sends them prompts. It can filter for free models.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: unorouter
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/unorouter/unorouter-mcp
- Updated: 2026-11-12
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/unorouter

## What it does

UnoRouter connects an MCP client to the UnoRouter model catalog and API. Its tools search the catalog, return prices in USD per million tokens, and send prompts to a model with its reply and token usage.

Model requests need a UnoRouter API key in `UNOROUTER_API_KEY`; calls cannot reach the API without it. The client starts the server with `npx -y unorouter-mcp`. `UNOROUTER_BASE_URL` is optional and defaults to `https://api.unorouter.com`.

Free models use shared pools and have a light per-model limit of about one request per minute. Requests can be spread across free models, or sent to paid models through UnoRouter.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.unorouter.com/mcp`
- Environment variables: `UNOROUTER_API_KEY`, `UNOROUTER_BASE_URL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://mcp.unorouter.com/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env UNOROUTER_API_KEY=<UNOROUTER_API_KEY> --env UNOROUTER_BASE_URL=<UNOROUTER_BASE_URL> --transport stdio unorouter -- npx -y unorouter-mcp
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add unorouter --url https://mcp.unorouter.com/mcp
```

2. **Platform CLI**
```bash
codex mcp add unorouter --env UNOROUTER_API_KEY=<UNOROUTER_API_KEY> --env UNOROUTER_BASE_URL=<UNOROUTER_BASE_URL> -- npx -y unorouter-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "unorouter": {
            "url": "https://mcp.unorouter.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "unorouter": {
            "command": "npx",
            "args": [
                "-y",
                "unorouter-mcp"
            ],
            "env": {
                "UNOROUTER_API_KEY": "<UNOROUTER_API_KEY>",
                "UNOROUTER_BASE_URL": "<UNOROUTER_BASE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "unorouter": {
            "type": "http",
            "url": "https://mcp.unorouter.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "unorouter": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "unorouter-mcp"
            ],
            "env": {
                "UNOROUTER_API_KEY": "<UNOROUTER_API_KEY>",
                "UNOROUTER_BASE_URL": "<UNOROUTER_BASE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http unorouter https://mcp.unorouter.com/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e UNOROUTER_API_KEY=<UNOROUTER_API_KEY> -e UNOROUTER_BASE_URL=<UNOROUTER_BASE_URL> unorouter npx -y unorouter-mcp
```
Replace <…> with your own values

## When to use it
- search the UnoRouter catalog with filters
- find free models
- check a model's price per million tokens
- send a prompt and inspect the reply and token usage

## Example prompts
- Find UnoRouter models that have a free option.
- Show model prices in USD per million tokens.
- Send this model a prompt and return the reply with token usage.

## Similar
- [Context7](https://affpapa.org/en/nevibecode/mcp/context7.md) — MCP server · 5563 installs
- [Search Google Flights](https://affpapa.org/en/nevibecode/mcp/search-google-flights.md) — MCP server · 2595 installs
- [Math-MCP](https://affpapa.org/en/nevibecode/mcp/math-mcp.md) — MCP server · 5958 installs
- [pipeworx gateway](https://affpapa.org/en/nevibecode/mcp/pipeworx-gateway.md) — MCP server · 419019 installs
- [SparkForge](https://affpapa.org/en/nevibecode/mcp/sparkforge.md) — MCP server · 219896 installs
- [OpenWebSearch](https://affpapa.org/en/nevibecode/mcp/openwebsearch.md) — MCP server · 494 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
