Log inSubmit server
Orcarouter MCP Server logo

Orcarouter MCP Server

by Continuum-AI-Corp

Browse OrcaRouter models and pricing, then route chat requests through automatic model selection and fallback chains.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Orcarouter MCP Server

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "continuum-ai-corp-orcarouter-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@orcarouter/mcp"
      ],
      "env": {
        "ORCAROUTER_API_KEY": "YOUR_VALUE_HERE",
        "ORCAROUTER_BASE_URL": "YOUR_VALUE_HERE",
        "ORCAROUTER_REQUEST_TIMEOUT": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 4 tools correctly (1mo ago).

Overview

Continuum-AI-Corp/orcarouter-mcp-server MCP server exposes OrcaRouter’s model catalog and chat gateway through MCP. It provides read-only tools for listing providers, filtering models, and inspecting model details without an API key. Chat requests require ORCAROUTER_API_KEY and can use automatic routing, direct provider/model targets, or fallback chains. Use Continuum-AI-Corp/orcarouter-mcp-server MCP server when an agent needs model discovery alongside routed LLM calls in an MCP-compatible client.

Use cases

  • Browse provider catalogs and compare model pricing
  • Filter models by capability or context length
  • Inspect detailed metadata for a selected model
  • Route chat requests through automatic model selection
  • Add fallback models for chat request resilience

Key features

  • OrcaRouter model and provider discovery
  • Server-side catalog filtering
  • Detailed model cards with pricing and latency
  • Automatic and direct chat routing
  • Fallback chains with up to five models
  • API-key-free catalog access

Tools4

What Orcarouter MCP Server lets your agent do. Expand a tool for its parameters.

Verified live~1.0k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

18/18 checks healthy over the last 78d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 8d ago via OSV.dev · @orcarouter/mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars13Stargazers on the source repository.
npm downloads263Package downloads in the last 30 days.
Last commit6d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed4Callable tools this server registers over MCP.
Directory activity6 viewsConfig copies, upvotes, and views on AllMCPs.

How Orcarouter MCP Server works

What Continuum-AI-Corp/orcarouter-mcp-server MCP server does

Continuum-AI-Corp/orcarouter-mcp-server MCP server connects MCP clients to OrcaRouter for two related tasks: exploring the available LLM catalog and sending chat completion requests. The catalog tools expose provider names, model metadata, pricing, context limits, capabilities, supported endpoints, latency percentiles, and release dates. These read-only operations do not require an OrcaRouter API key.

The chat tool sends a single-turn request and returns the assistant’s response text. It can use the workspace’s automatic router by default, address another OrcaRouter router, or call a provider/model directly. This makes the server suitable for agents that need to compare models before choosing one, or that should delegate model selection to OrcaRouter.

How it works

The package runs as a local Node.js MCP process and communicates with the client through the MCP protocol. MCP clients discover the available input schemas through tools/list, so the client can present or invoke the four exposed tools without a separate tool-definition setup.

orcarouter_providers_list returns provider identifiers and model counts. Those identifiers can then be supplied to orcarouter_models_list, whose provider, capability, and minimum-context filters are combined server-side. orcarouter_model_card is intended for a known model ID and returns a fuller record than the catalog listing.

For chat, the primary model is attempted first. An optional models array can add up to four fallbacks, for a maximum chain of five models including the primary. Requests aimed at OpenAI reasoning models have max_tokens translated to max_completion_tokens at the wire level. Failures, including missing credentials, rate limits, and upstream outages, are returned as error text with isError: true.

Setup and configuration

Install and run Continuum-AI-Corp/orcarouter-mcp-server MCP server with Node.js 18 or newer:

Terminal
npx -y @orcarouter/mcp

Add the command to an MCP client configuration, then provide ORCAROUTER_API_KEY for chat calls. The key is read from the environment, is not logged, and is sent only to the OrcaRouter API.

Configuration variables include:

  • ORCAROUTER_API_KEY: required only by orcarouter_chat.
  • ORCAROUTER_BASE_URL: optional API base URL; the default is https://api.orcarouter.ai.
  • ORCAROUTER_REQUEST_TIMEOUT: optional per-request timeout in seconds; the default is 300.

Tools and capabilities

Continuum-AI-Corp/orcarouter-mcp-server MCP server exposes these tools:

  • orcarouter_chat: Send a single-turn chat request with router, direct model, and fallback-chain options.
  • orcarouter_models_list: Browse the complete catalog or filter it by provider, capability, and minimum context length.
  • orcarouter_model_card: Retrieve detailed metadata for one model, including pricing, modalities, context window, output limit, endpoints, latency, and release date.
  • orcarouter_providers_list: List providers with IDs, display names, icon URLs, and model counts.

The catalog can be used before authentication to compare available models and pricing. Chat routing is the only listed capability that needs the OrcaRouter credential.

Limitations and notes

The server performs single-turn chat requests rather than describing a multi-turn conversation or agent memory feature. Catalog results are read-only. Provider and model identifiers must match the OrcaRouter catalog; the provider-list tool is the documented way to discover valid provider IDs. The fallback chain is limited to five total entries, including the primary model. API availability, rate limits, and provider outages can still cause chat errors even when the MCP process is running.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Orcarouter MCP Server

Run `npx -y @orcarouter/mcp` with Node.js 18 or later, then add the command to an MCP client configuration.

Yes. The README provides a Claude Desktop configuration example, and the server is also described as compatible with MCP clients such as Cursor and Windsurf.

Only chat requests require `ORCAROUTER_API_KEY`; provider and model catalog tools work without one.

Pass a primary model and an optional `models` array to `orcarouter_chat`. The primary is tried first, followed by up to four fallback entries.

Related MCP servers

All in Aggregators All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewOrcarouter MCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/continuum-ai-corp-orcarouter-mcp-server?style=directory)](https://allmcps.com/mcp/continuum-ai-corp-orcarouter-mcp-server)
HTML Embed
<a href="https://allmcps.com/mcp/continuum-ai-corp-orcarouter-mcp-server"><img src="https://allmcps.com/api/badge/continuum-ai-corp-orcarouter-mcp-server?style=directory" alt="Orcarouter MCP Server on AllMCPs" /></a>