OpenRouter Zero MCP
This server provides an MCP interface to OpenRouter for model inference, account/model discovery, and API key management.
Run chat completions on any OpenRouter model (
openrouter_chat_completion) with prompt/messages, model, temperature, max tokens, and reasoning options.Check credit balance, usage, and API key limits (
openrouter_get_credits).Search/list OpenRouter models with pricing, context window, and filters (
openrouter_list_models).List, create, or delete OpenRouter API keys via the Management API (
openrouter_manage_keys).
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@OpenRouter Zero MCP ask Claude 3.7 Sonnet to explain this Python traceback"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
⚡ OpenRouter Zero MCP (openrouter-zero-mcp)
The Fastest, Lightest OpenRouter MCP Server for AI Agents.
(Zero third-party dependencies, <30ms startup, multi-model inference for DeepSeek, Claude, Gemini & Llama).
# ⚡ 1-Click Install via skills.sh (Claude Code / Codex / Antigravity):
npx skills add Gabrielrtads/openrouter-zero-mcp
# Or install automatically via Smithery for Claude Desktop:
npx -y @smithery/cli install @Gabrielrtads/openrouter-zero-mcp --client claude⚡ Why OpenRouter Zero?
Feature | Typical OpenRouter MCPs |
|
Dependencies | 100+ npm packages or heavy Python venv | Zero (0) native Node.js only |
Startup Latency | 1.2s - 3.5s | < 30ms instant boot |
Memory Footprint | ~120MB+ | ~15MB |
JSON-RPC Spec | Often crashes on notifications | 100% Spec-Compliant (Handles notifications correctly) |
Related MCP server: Zen MCP Server
💻 Manual Setup
1. Claude Desktop
Add this to your claude_desktop_config.json:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"openrouter": {
"command": "npx",
"args": ["-y", "openrouter-zero-mcp"],
"env": {
"OPENROUTER_API_KEY": "sk-or-v1-your-key-here"
}
}
}
}2. Cursor IDE
Open Cursor Settings (
Ctrl+Shift+JorCmd+Shift+J).Navigate to Features > MCP Servers > Add New MCP Server.
Fill in:
Name:
openrouterType:
commandCommand:
npx -y openrouter-zero-mcpEnvironment Variables:
OPENROUTER_API_KEY=sk-or-v1-your-key-here
3. Antigravity / Windsurf / Claude Code
In your mcp_config.json:
{
"mcpServers": {
"openrouter": {
"command": "npx",
"args": ["-y", "openrouter-zero-mcp"],
"env": {
"OPENROUTER_API_KEY": "sk-or-v1-your-key-here"
}
}
}
}🛠️ Available MCP Tools
1. openrouter_chat_completion
Executes chat completions on any model in the OpenRouter catalog (DeepSeek V3/R1, Gemini 2.5 Flash, Claude 3.7 Sonnet, Llama 3.3 70B, etc.).
Parameters:
model,messages,prompt,temperature,max_tokens,reasoning.
2. openrouter_get_credits
Checks real-time credit balance, usage, and key parameters.
3. openrouter_list_models
Searches and lists models from the OpenRouter API with pricing per 1M tokens and context window size.
Parameters:
search(e.g.'deepseek','gemini','free'),limit.
4. openrouter_manage_keys
Provisions, lists, or revokes API keys via the OpenRouter Management API.
Parameters:
action('list','create','delete'),name,limit,hash.
🔒 Security & Privacy
All API calls are made directly to
https://openrouter.ai/api/v1with your personal key.Zero analytics, zero telemetry, zero middleman proxy.
Secrets are read exclusively from environment variables.
⭐ Impressed with OpenRouter Zero?
If this MCP server saved your tokens or sped up your workflow, please star the repository!
It helps other autonomous agent developers discover the project.
Built with pride by Gabriel Toledo (@Gabrielrtads)
Creator of Barber.fi, vibe-design-studio, sta, kage-bunshin, and agent-log.
Licensed under MIT.
Available Tools
4 toolsopenrouter_chat_completionC
Execute chat inference on any model available on OpenRouter (e.g. google/gemini-2.5-flash, anthropic/claude-3.7-sonnet, deepseek/deepseek-v4-flash-0731:US, meta-llama/llama-3.3-70b-instruct).
Inputs: model, prompt, messages, reasoning, +2 more.
openrouter_get_creditsB
Retrieve account balance, credits usage, and API key limits from OpenRouter.
Inputs: no named parameters.
openrouter_list_modelsC
List available AI models on OpenRouter with filters for name, slug, context window size, and pricing.
Inputs: limit, search.
openrouter_manage_keysB
Manage OpenRouter API keys (list, create, delete) via the Management API. Requires OPENROUTER_MANAGEMENT_KEY.
Inputs: action (required), hash, name, limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool targets a clearly distinct area: chat inference, account credits, model listing, and API key management. There is no meaningful overlap or ambiguity in intent.
All tools share the openrouter_ prefix and snake_case format, which is highly consistent. The only minor deviation is openrouter_chat_completion, which is noun-based rather than verb_noun like the other three.
Four well-scoped tools cleanly cover the OpenRouter integration surface without redundancy. Each tool earns its place for a focused MCP server.
Core workflows are covered: inference, model discovery, credits, and key lifecycle. Minor gaps exist around richer generation options (e.g. embeddings, streaming controls, per-model usage), but agents can work around them.
Maintenance
Related MCP Connectors
The OpenRouter MCP server plugs OpenRouter into the AI tools you already use. Once connected, your assistant can pull live OpenRouter data (models, prices, your credits, rankings, and docs) and send quick test messages, all without leaving your editor.
AI routing, memory, guardrails, and governance. Routes across Claude, GPT, Gemini.
One memory for Claude, ChatGPT and Cursor, kept on your computer. Optional sync, encrypted first.
AI model routing on your own vendor keys: pick the best model per prompt, or route and run it.
Related MCP Servers
- AlicenseAqualityDmaintenanceProvides integration with OpenRouter.ai, allowing access to various AI models through a unified interface.4302 npm64Apache 2.0
- FlicenseNot gradedqualityNot gradedmaintenanceGives Claude Desktop access to multiple AI models (Gemini, OpenAI, OpenRouter, Ollama) for enhanced development capabilities including extended reasoning, collaborative development, code review, debugging, and large context analysis with conversation threading.40 npm1-
- AlicenseNot gradedqualityDmaintenanceEnables chat and image analysis through OpenRouter.ai models. Supports text chat, image generation, and analysis with multiple images and custom questions.MIT
- AlicenseAqualityBmaintenanceEnables calling 48+ LLMs, image, and video models through Routara's API from Cursor, Claude Desktop, Windsurf, and other MCP clients. Supports chat completions, image generation, and video generation with a single API key.552 npm1MIT