Skip to main content
Watch: I Built an AI App Without Leaving Databricks

AI and ML platforms - official OpenRouter server

OpenRouter MCP server

Remote MCP server hosted by OpenRouter that lets coding assistants pull live model catalog, pricing, provider endpoint, benchmark, ranking and credit data, search the OpenRouter docs, and send billable test messages or image generations. OpenRouter hosts it at https://mcp.openrouter.ai/mcp with OAuth auth.

Last verified 15 tools3 sources

Install

Terminal
claude mcp add --transport http openrouter https://mcp.openrouter.ai/mcp
claude mcp login openrouter
Terminal
codex mcp add openrouter --url https://mcp.openrouter.ai/mcp
codex mcp login openrouter   # opens the browser OAuth flow
JSON
{
  "mcpServers": {
    "openrouter": { "url": "https://mcp.openrouter.ai/mcp" }
  }
}

Tools

send-message
Send a message to any model and get its reply, to test a prompt or compare models (billable).
generate-image
Generate an image from a text prompt and return it inline (billable).
list-models
Search the live model catalog with free-text search, sorting, and filters such as price, context, modality, provider and benchmarks.
get-model
Full details for one model by author/slug.
list-model-endpoints
Which providers serve a model, with price, latency, throughput, and data policy.
list-providers
List available providers for routing preferences.
list-daily-model-rankings
Which models are most used and trending by token volume.
list-app-rankings
Which apps drive the most OpenRouter traffic, filterable by category.
get-credits
Your remaining account credit.
get-generation
Cost, token counts, and serving provider for a specific generation id.
list-benchmarks
Third-party quality scores from Artificial Analysis and Design Arena.
list-task-classifications
Market share of OpenRouter traffic by task type with top models for each.
search-docs
Search the full OpenRouter docs.
send-feedback
Report a problem with one of your own generations to the OpenRouter team.
ping
Health check to verify the connection.

As documented on October 17, 2026. A running server reports its current list through tools/list.

Notes and caveats

  • Remote only.
  • OAuth (PKCE with client registration) mints a dedicated OpenRouter API key labelled 'OpenRouter MCP: <app name>' with a 7-day expiry and a default $10 spend cap (editable on the consent screen); re-authenticate after expiry.
  • Intended as a development assistant, not for running models in production apps.
  • Not in Claude's connector directory, so Claude Desktop/Web users add it as a custom connector.
  • Docs also document OpenCode config; the Cursor snippet is documented for ~/.cursor/mcp.json (Cursor CLI and IDE).
  • Additional tools spawn-ori-eval and install-ori-harness are also listed.
  • The separate @openrouter/mcp npm package is an MCP client helper for the Agent SDK, not this server.

FAQ

What does the OpenRouter MCP server do?

Remote MCP server hosted by OpenRouter that lets coding assistants pull live model catalog, pricing, provider endpoint, benchmark, ranking and credit data, search the OpenRouter docs, and send billable test messages or image generations. The vendor documents 15 tools, including send-message, generate-image, list-models and get-model.

How do I add the OpenRouter MCP server to Claude Code?

OpenRouter documents a Claude Code config; copy it from the Claude Code section of this page. Snippets for Codex and Cursor are there too.

Does the OpenRouter MCP server need authentication?

Yes, OAuth. Transport: Streamable HTTP. Status: Unlabelled, last checked October 17, 2026.

Sources

Last verified against 3 OpenRouter pages, then re-checked independently.

Newsletter

New MCP servers, the week they ship

One email per week. New official MCP servers, the coding tools that support them and how developers wire them up.