# UnoRouter

> UnoRouter is a freemium MCP server for ai models and llm tooling. Search models, check prices and chat through one OpenAI-compatible UnoRouter key. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $20 a month
- **Platforms:** Web, API, CLI
- **Website:** https://unorouter.com
- **Repository:** https://github.com/unorouter/unorouter-mcp
- **MCP Registry name:** com.unorouter/mcp
- **Categories:** AI models and LLM tooling
- **Listing updated:** 2026-11-14

## About

The server is the agent-facing side of UnoRouter, a service that fronts hundreds of models behind one OpenAI-compatible key. It lets an assistant search the model list, including free ones, check prices and send chat requests through that key.

It can run locally over stdio as the unorouter-mcp npm package, which needs an UNOROUTER_API_KEY and optionally a base URL override, or as a hosted streamable-HTTP endpoint.

Models whose names end in :free cost nothing, limited to about one request per minute per model. Paid models run on pay-as-you-go credit from a $1 top-up that does not expire, or on subscription plans that add extra credit.

## Features

- **Model search:** Look up available models, free ones included.
- **Price checks:** Compare what models cost before calling them.
- **Chat through one key:** Send requests with a single OpenAI-compatible key.
- **Local or hosted:** Run the npm package over stdio or use the remote endpoint.
- **Free models:** Models ending in :free have no charge but a request-rate limit.

## Good for

- Pick a cheaper model for a coding agent
- Find free models for a side project
- Route requests from an assistant to several providers via one key
- Check prices from inside a chat

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp https://mcp.unorouter.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.unorouter.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.unorouter.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.unorouter.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://mcp.unorouter.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.unorouter.com/mcp"
    }
  }
}
```

## Tools

- `search_models`: Search the live UnoRouter model catalog (every major provider behind one OpenAI-compatible key). Models ending in :free cost nothing. Returns matching model IDs usable with the chat tool or any OpenAI-compatible client pointed at https://api.unorouter.com/v1.
- `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 rate). :free models are always 0.

## FAQ

### Is there a free option?

Yes. Models ending in :free cost nothing, limited to about one request per minute per model, and no card is needed to start.

### What does paid usage cost?

Pay as you go from a $1 top-up, or plans such as Starter at $20 a month for $40 of credit.

### Does it need an API key?

The npm package requires UNOROUTER_API_KEY.

### Does credit expire?

Pay-as-you-go credit never expires.

### Is UnoRouter free?

UnoRouter has a free plan, with paid plans for more usage or features. Paid plans start at $20 a month.

### How do I add UnoRouter to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://mcp.unorouter.com/mcp

### What are the best alternatives to UnoRouter?

The closest alternatives to UnoRouter are Claude Code Ultimate Guide, signafAIde, Toolkien, Lugh and HypePaper.

## Alternatives

- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [signafAIde](https://ai-powered.com/mcp/signafaide): signafAIde is a freemium MCP server for security.
- [Toolkien](https://ai-powered.com/mcp/toolkien): Toolkien is an open-source MCP server for ai models and llm tooling.
- [Lugh](https://ai-powered.com/mcp/lugh): Lugh is an open-source MCP server for ai models and llm tooling.
- [HypePaper](https://ai-powered.com/mcp/hypepaper): HypePaper is a freemium MCP server for ai models and llm tooling.
- [Agent Data Tools: Compact (find, describe, run)](https://ai-powered.com/mcp/agent-data-tools-compact-find-describe-run): Agent Data Tools: Compact (find, describe, run) is a freemium MCP server for developer tools.
- [Angel Agent Guard: pre-purchase check + prompt-injection scan](https://ai-powered.com/mcp/angel-agent-guard-pre-purchase-check-prompt-injection-scan): Angel Agent Guard: pre-purchase check + prompt-injection scan is a freemium MCP server for ai models and llm tooling.
- [Mizan Calibration](https://ai-powered.com/mcp/mizan-calibration): Mizan Calibration is a free MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/unorouter
