OpenRouter MCP server
io.github.tsilva/mcp-openrouter·v1.1.8·1 starsMCP server providing access to 300+ AI models via OpenRouter
1 stars
Reviews
Write oneNobody has reviewed OpenRouter yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
OpenRouter tools
No tool declarations could be read from the package source. They show once the server is installed.
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan9 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 44 days ago12/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How OpenRouter compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 78/100
- higher than 57% of 48,255 servers
- GitHub stars
- 1
- more than 65% of 28,688 servers
Install OpenRouter in Claude Code, Cursor or VS Code
claude mcp add mcp-openrouter -- uvx mcp-openrouter
What the publisher says
From the OpenRouter repository's README, as published. We do not edit it. Read it on GitHub
🚀 One MCP server for OpenRouter models 🚀
<!-- mcp-name: io.github.tsilva/mcp-openrouter -->
mcp-openrouter is a Python MCP server that lets Codex, Claude Code, opencode, and other MCP hosts call OpenRouter models from local stdio tools.
It exposes chat, image generation, embeddings, model listing, and model search through a small FastMCP server with retry handling, host-aware installation, and optional default model environment variables.
Install
Install the published server into every detected MCP client:
uvx mcp-openrouter install --yesInstall into selected clients:
uvx mcp-openrouter install --yes --clients codex,claude,opencodeRun from a local checkout:
git clone https://github.com/tsilva/mcp-openrouter.git
cd mcp-openrouter
uv sync --dev
keyenv doctor
keyenv run -- uv run mcp-openroutermcp-openrouter with no arguments starts the stdio server. The explicit command is uv run mcp-openrouter serve.
Commands
uvx mcp-openrouter install --yes # install into detected MCP clients
uvx mcp-openrouter install --yes --force # replace an existing openrouter config
uvx mcp-openrouter uninstall --yes # remove from detected MCP clients
uv run mcp-openrouter # run the local stdio server
uv run pytest tests/test_cli.py tests/test_client.py tests/test_config.py tests/test_installer.py tests/test_release_metadata.py tests/test_server.py
keyenv run -- uv run pytest tests/test_tools.py
uv run ruff check src/
uv run ruff format src/Tools
Example MCP prompts:
Use openrouter chat with anthropic/claude-sonnet-4 to summarize this file
Use openrouter generate_image with google/gemini-3-pro-image-preview to create a square app icon
Use openrouter embed with mistralai/mistral-embed-2312 to embed "Hello world"
Use openrouter list_models with capability "image_gen"
Use openrouter find_models to search for "claude"Configuration
OPENROUTERAPIKEY is required for all tool calls. For a local checkout, its .keyenv.toml maps the variable to macOS Keychain: use keyenv set OPENROUTERAPIKEY to replace it, keyenv doctor to verify it, and keyenv run -- ... to launch the server or live tests. Python still reads the value normally from os.environ.
Optional defaults make the model parameter optional for matching tools:
DEFAULT_TEXT_MODEL=google/gemini-3-pro-image-preview
DEFAULT_IMAGE_MODEL=google/gemini-3-pro-image-preview
DEFAULT_CODE_MODEL=anthropic/claude-sonnet-4.5
DEFAULT_VISION_MODEL=google/gemini-3-pro-image-preview
DEFAULT_EMBEDDING_MODEL=mistralai/mistral-embed-2312The current tools read DEFAULTTEXTMODEL, DEFAULTIMAGEMODEL, and DEFAULTEMBEDDINGMODEL. DEFAULTCODEMODEL and DEFAULTVISIONMODEL are available for client conventions. Non-secret defaults may remain in .env; the API key must not.
Notes
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
OpenRouter: common questions
- Is OpenRouter MCP server safe?
- Mostly: it is graded B (78/100). Read the OpenRouter safety report
- How do I install OpenRouter?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does OpenRouter need an API key?
- Yes. The registry entry asks for
OPENROUTER_API_KEY. - Is OpenRouter maintained?
- The last commit was 82 days ago (2026-08-14). The latest release is v1.1.8.
- How does OpenRouter compare with other MCP servers?
- safety score 78/100 (higher than 57% of 48,255 servers); github stars 1 (more than 65% of 28,688 servers). Full comparison.