orcarouter-mcp-server

<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's model catalog and run chat completions from inside any Model Context Protocol 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)

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 | Replace | | Claude Code | claude-code.json | Merge | | Cursor | cursor.json | Replace | | Windsurf | windsurf.json | Replace |

See examples/README.md for the config-file paths and notes on Zed and other clients.

1. Replace sk-or-... in the copied file with your OrcaRouter API key.
2. Restart your MCP client.

The root .mcp.json is the same config in the Open Plugins standard location, so registry/discovery tools that scan for it (e.g. 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 for the vulnerability disclosure policy.

Development

# 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. For newcomer-friendly tasks, browse the good first issue label.

License

MIT