OrcaRouter
Browse 160+ LLM models and live pricing — no API key needed for catalog. Add key to route chat.
Open source Open in the app JSON README (API)
About
Browse 160+ LLM models and live pricing — no API key needed for catalog. Add key to route chat.
Details
- Kind
- MCP servers
- Topic
- AI, RAG & memory
- Publisher
- continuum-ai-corp
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.1.5
- Stars
- 12
- Forks
- 4
- Last push
- 2026-05-26T19:28:40Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-08-29 03:01:48
- Updated
- 2026-08-29 03:01:48
- Origin id
io.github.Continuum-AI-Corp/orcarouter-mcp
README
<p align="center">
<a href="https://www.orcarouter.ai">
<img src="https://raw.githubusercontent.com/Continuum-AI-Corp/orcarouter-mcp-server/main/assets/logo.gif" alt="OrcaRouter" width="180" />
</a>
</p>
<h1 align="center">OrcaRouter MCP Server</h1>
<p align="center">
Official MCP server for the <a href="https://www.orcarouter.ai">OrcaRouter</a> LLM gateway.
</p>
<p align="center">
<a href="https://discord.com/invite/943Zqp9bs"><img src="https://img.shields.io/discord/1501106943178309662?logo=discord&label=discord&color=5865F2" alt="Discord" /></a>
<a href="https://x.com/OrcaRouter"><img src="https://img.shields.io/badge/X-Follow-000000?logo=x&logoColor=white" alt="X" /></a>
<a href="https://www.npmjs.com/package/@orcarouter/mcp"><img src="https://img.shields.io/npm/v/@orcarouter/mcp" alt="npm version" /></a>
<a href="https://github.com/Continuum-AI-Corp/orcarouter-mcp-server/actions/workflows/test.yml"><img src="https://github.com/Continuum-AI-Corp/orcarouter-mcp-server/actions/workflows/test.yml/badge.svg" alt="CI" /></a>
<a href="https://smithery.ai/servers/continuum-ai-corp/orcarouter-mcp"><img src="https://smithery.ai/badge/continuum-ai-corp/orcarouter-mcp" alt="Smithery" /></a>
</p>
<p align="center">
<a href="README.md">English</a> | <a href="README.ja.md">日本語</a> | <a href="README.zh-CN.md">中文</a> | <a href="README.ko.md">한국어</a> | <a href="README.de.md">Deutsch</a> | <a href="README.fr.md">Français</a> | <a href="README.es.md">Español</a> | <a href="README.it.md">Italiano</a> | <a href="README.ru.md">Русский</a> | <a href="README.pt.md">Português</a> | <a href="README.vi.md">Tiếng Việt</a> | <a href="README.hi.md">हिन्दी</a>
</p>
<br/>
Browse [OrcaRouter](https://www.orcarouter.ai)'s model catalog and run chat
completions from inside any [Model Context Protocol](https://modelcontextprotocol.io)
client — Claude Desktop, Claude Code, Cursor, Windsurf, Zed, or anything
else that speaks the protocol.
Catalog browsing works **without an API key** — compare pricing and
capabilities before signing up.
## What you can do
- 🗺️ Discover providers and models without an API key
- 💬 Run chat completions through any served model
- 🧠 Auto-route requests through your workspace's `orcarouter/auto` router (cost / quality / balanced / LinUCB / gated-adaptive strategies)
- 🔁 Configure fallback chains (primary + up to 4 fallbacks) for resilience
- 📊 Filter models server-side by provider, capability, or minimum context window
- 🎯 Inspect detailed model cards: pricing, context, latency, supported endpoints
- 🔌 Works with Claude Desktop, Claude Code, Cursor, Windsurf, Zed, and any MCP client
## Examples
Try saying things like:
- *"List all providers on OrcaRouter"*
- *"Show me all Anthropic models with their pricing"*
- *"Get details about `minimax/minimax-m2.7`"*
- *"Chat with `orcarouter/auto` and explain quantum computing"*
## Quick Start
### Claude Code (CLI one-liner)
```bash
claude mcp add orcarouter -s user \
-e ORCAROUTER_API_KEY=sk-orca-your-key \
-- npx -y @orcarouter/mcp
```
### Other clients (config-file path)
1. Copy the example config for your MCP client into the client's config file:
| Client | Example | Action |
| --------------- | --------------------------------------------------- | ------- |
| Claude Desktop | [claude-desktop.json](examples/claude-desktop.json) | Replace |
| Claude Code | [claude-code.json](examples/claude-code.json) | Merge |
| Cursor | [cursor.json](examples/cursor.json) | Replace |
| Windsurf | [windsurf.json](examples/windsurf.json) | Replace |
See [`examples/README.md`](examples/README.md) for the config-file paths and notes on Zed and other clients.
2. Replace `sk-or-...` in the copied file with your [OrcaRouter API key](https://www.orcarouter.ai/console).
3. Restart your MCP client.
The root [`.mcp.json`](.mcp.json) is the same config in the [Open Plugins](https://open-plugins.com) standard location, so registry/discovery tools that scan for it (e.g. [cursor.directory](https://cursor.directory)) can pick this server up automatically.
Requires Node.js 18 or later. The `ORCAROUTER_API_KEY` env var is only
required for `orcarouter_chat`; catalog tools work without it.
## Tools
- `orcarouter_chat` — run a chat completion (with optional fallback chain)
- `orcarouter_models_list` — browse the catalog (pricing, context, capabilities)
- `orcarouter_model_card` — detailed info for one model
- `orcarouter_providers_list` — list providers with model counts
Full input schemas are exposed at runtime via the MCP `tools/list` method — your MCP client (Claude Desktop, Cursor, etc.) reads them automatically.
## Configuration
| Name | Required | Description |
| --------------------------- | -------- | -------------------------------------------------------- |
| `ORCAROUTER_API_KEY` | optional | OrcaRouter API key. Required only for `orcarouter_chat`. |
| `ORCAROUTER_BASE_URL` | optional | API base URL. Defaults to `https://api.orcarouter.ai`. |
| `ORCAROUTER_REQUEST_TIMEOUT`| optional | Per-request HTTP timeout in **seconds**. Defaults to `300`. |
## Security
API keys are read from environment variables, never logged, and only
sent to the OrcaRouter API. See [SECURITY.md](SECURITY.md) for the
vulnerability disclosure policy.
## Development
```sh
# bun (preferred)
bun install
bun run test
bun run typecheck
bun run build
# or with npm
npm install
npm test
npm run typecheck
npm run build
```
The build produces an ESM bundle at `dist/index.js` with a
`#!/usr/bin/env node` shebang, runnable as the `orcarouter-mcp` binary.
## Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md). For newcomer-friendly tasks, browse the [`good first issue`](https://github.com/Continuum-AI-Corp/orcarouter-mcp-server/labels/good%20first%20issue) label.
## License
[MIT](LICENSE)