Config is the same across clients — only the file and path differ.
{
"mcpServers": {
"io-github-tsilva-mcp-openrouter": {
"args": [
"mcp-openrouter"
],
"command": "uvx"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
mcp-openrouter is a Python MCP server that lets Codex, Claude Code, opencode, and other MCP hosts call OpenRouter models from local stdio tools.
Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.
uvx 'mcp-openrouter' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Five weighted categories — click any category to see the underlying evidence.
No known CVEs.
Checked mcp-openrouter against OSV.dev.
Click any tool to inspect its schema.
Be the first to review
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Others in ai-ml
Dynamic problem-solving through sequential thought chains
Persistent memory using a knowledge graph
An autonomous agent that conducts deep research on any data using any LLM providers
🌊 The leading agent orchestration platform for Claude. Deploy intelligent multi-agent swarms, coordinate autonomous workflows, and build conversational AI systems. Features enterprise-grade architecture, distributed swarm intelligence, RAG integration, and native Claude Code / Codex Integration
MCP Security Weekly
Get CVE alerts and security updates for io.github.tsilva/mcp-openrouter and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
🚀 One MCP server for OpenRouter models 🚀
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 .env support, retry handling, host-aware installation, and optional default model environment variables.
Install the published server into every detected MCP client:
uvx mcp-openrouter install --yes
Install into selected clients:
uvx mcp-openrouter install --yes --clients codex,claude,opencode
Pass the OpenRouter key directly for non-interactive setup:
uvx mcp-openrouter install --yes --api-key sk-or-v1-...
Run from a local checkout:
git clone https://github.com/tsilva/mcp-openrouter.git
cd mcp-openrouter
uv sync --dev
OPENROUTER_API_KEY=your-key uv run mcp-openrouter
mcp-openrouter with no arguments starts the stdio server. The explicit command is uv run mcp-openrouter serve.
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
OPENROUTER_API_KEY=your-key uv run pytest tests/test_tools.py
uv run ruff check src/
uv run ruff format src/
| Tool | Purpose |
|---|---|
chat | Send a prompt or message list to an OpenRouter chat model. |
generate_image | Generate one image and optionally save it to an absolute local path. |
embed | Generate embeddings for a string or list of strings. |
list_models | List models, optionally filtered by vision, image_gen, embedding, tools, or long_context. |
find_models | Search model names and slugs, returning up to 20 matches. |
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"
OPENROUTER_API_KEY is required for all tool calls. Set it in your shell, pass it during installation, or put it in .env.
Optional defaults make the model parameter optional for matching tools:
OPENROUTER_API_KEY=sk-or-v1-your-key-here
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-2312
The current tools read DEFAULT_TEXT_MODEL, DEFAULT_IMAGE_MODEL, and DEFAULT_EMBEDDING_MODEL. DEFAULT_CODE_MODEL and DEFAULT_VISION_MODEL are available for client conventions. The server loads .env from the current working directory and from the repository root when running from a checkout.
uvx mcp-openrouter.generate_image.output_path must be absolute, for example /Users/you/output.png.tests/test_tools.py requires a live OPENROUTER_API_KEY.