Provides access to Google's Gemini models including Gemini 2.5 Pro/Flash with 1M+ context windows through OpenRouter, supporting both text-only and vision capabilities.
Enables interaction with Meta's Llama models including Llama 3.3, Llama 3.2 vision models, and Llama 2 chat models through OpenRouter's unified API.
Provides access to OpenAI models including GPT-4o, GPT-4 Turbo, and GPT-3.5 Turbo through OpenRouter's unified API, with support for text and vision capabilities, streaming responses, and usage tracking.
Provides access to Perplexity's web-connected Llama 3 Sonar models through OpenRouter, enabling AI interactions with real-time web information.
Click on "Install 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 MCP Servercompare GPT-4o and Claude 3.5 for analyzing this image"
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 MCP Server
A Model Context Protocol (MCP) server for OpenRouter. Use OpenRouter models from MCP clients (Claude Desktop, Claude Code, etc.) with chat, vision, benchmarking, and collective-intelligence tools.
Features
MCP tools: chat, model listing, usage stats, vision chat, vision model listing
Benchmarking suite and performance comparison tools
Collective intelligence tools (consensus, ensemble reasoning, adaptive routing, cross-model validation, collaborative solving)
Secure API key storage (OS keychain, encrypted file, or .env) with audit logging
Streaming responses, caching, and rich model metadata
Quick start
npx @physics91/openrouter-mcp init
npx @physics91/openrouter-mcp startGlobal install:
npm install -g @physics91/openrouter-mcp
openrouter-mcp init
openrouter-mcp startPrerequisites
Node.js 16+
Python 3.9+ (dependencies auto-installed on first run)
OpenRouter API key: https://openrouter.ai
CLI
Use openrouter-mcp <command> or npx @physics91/openrouter-mcp <command>.
Commands:
startStart the MCP server (stdio)initInitialize API key storagestatusShow configuration statusinstall-claudeConfigure Claude Desktopinstall-claude-codeConfigure Claude Code CLIrotate-keyRotate API key across storagedelete-credentialsRemove stored credentialssecurity-auditAudit credential storage and permissionsmigrate-encryptionMigrate encrypted credentials to v2.0
Common options: --verbose, --debug, --host, --port.
Integrations
Claude Desktop:
openrouter-mcp install-claudeClaude Code CLI:
openrouter-mcp install-claude-code
See:
docs/CLAUDE_DESKTOP_GUIDE.mddocs/CLAUDE_CODE_GUIDE.md
Notes
Vision tools accept images as base64 or URL only (file paths are not supported).
API keys should not be committed. Use
initfor secure storage. SeeSECURITY.md.
Documentation
docs/INDEX.mddocs/INSTALLATION.mddocs/API.mddocs/MULTIMODAL_GUIDE.mddocs/BENCHMARK_GUIDE.mddocs/SECURE_STORAGE_INTEGRATION.mddocs/QUICK_REFERENCE.md
Contributing
See CONTRIBUTING.md.
License
MIT