H
heltonteixeira/openrouterai
MCP server for OpenRouter.ai integration
View on GitHub ↗Link checked 2026-11-12 · HTTP 200 · opens the vendor's own site
Install & config
Client config (built from the install command this repo gives)
{
"mcpServers": {
"heltonteixeira-openrouterai": {
"command": "npx",
"args": ["@mcpservers/openrouterai"]
}
}
}Parsed from the README we fetched on 2026-11-05; we have not executed it.
command/args come from the install command the repository states. When it is ambiguous, the project README wins.
VS Code (.vscode/mcp.json - the key is servers)
{
"servers": {
"heltonteixeira-openrouterai": {
"command": "npx",
"args": ["@mcpservers/openrouterai"]
}
}
}Same server, but VS Code keeps it under <code>servers</code>.
Claude Code (command line)
claude mcp add --transport stdio heltonteixeira-openrouterai -- npx @mcpservers/openrouterai
Claude Code does not read a config file; add the server with this command.
Key names differ by client: Clients & CLI
- Source
- collected from the abordage/awesome-mcp list · type: MCP server
- Harvest history
- first seen 2026-11-05 · last seen 2026-11-14 · seen 10× · listed by 10 sources
- Score
- score 1,003 · 10 sources · mcp
- Install
npx @mcpservers/openrouterai
FAQ (answers come from our records)
How do I install it?
The repository provides this install command:
npx @mcpservers/openrouterai. It comes from the repository itself; we cannot guarantee it runs as-is in your client.Who is it for?
We filed it under these tags: MCP 服务. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
first catalogued 2026-11-05；last seen 2026-11-14。There is no official certification or quality rating here — we record sources and dates only.
# OpenRouter MCP Server
以下摘录自该仓库的 README（片段） · 在 GitHub 读完整 README →
A Model Context Protocol (MCP) server providing seamless integration with OpenRouter.ai's diverse model ecosystem. Access various AI models through a unified, type-safe interface with built-in caching, rate limiting, and error handling.
## Features
Model Access
Direct access to all OpenRouter.ai models
Automatic model validation and capability checking
Default model configuration support
Performance Optimization
Smart model information caching (1-hour expiry)
Automatic rate limit management
Exponential backoff for failed requests
Unified Response Format
Consistent ToolResult structure for all responses
Clear error identification with isError flag
Structured error messages with context
## Installation
bash
pnpm install @mcpservers/openrouterai
## Configuration
### Prerequisites
1. Get your OpenRouter API key from OpenRouter Keys
2. Choose a default model (optional)
### Environment Variables
OPENROUTERAPIKEY: Required. Your OpenRouter API key.
OPENROUTERDEFAULTMODEL: Optional. The default model to use if not specified in the request (e.g., openrouter/auto).
OPENROUTERMAXTOKENS: Optional. Default maximum number of tokens to generate if maxtokens is not provided in the request.
OPENROUTERPROVIDERQUANTIZATIONS: Optional. Comma-separated list of default quantization levels to filter by (e.g., fp16,int8) if provider.quantizations is not provided in the request. (Phase 1)
OPENROUTERPROVIDERIGNORE: Optional. Comma-separated list of default provider names to ignore (e.g., mistralai,openai) if provider.ignore is not provided in the request. (Phase 1)
OPENROUTERPROVIDERSORT: Optional. Default sort order for providers ("price", "throughput", or "latency"). Overridden by provider.sort argument. (Phase 2)
OPENROUTERPROVIDERORDER: Optional. Default prioritized list of provider IDs (JSON array string, e.g., '["openai/gpt-4o", "anthropic/claude-3-opus"]'). Overridden by provider.order argument. (Phase 2)
OPENROUTERPROVIDERREQUIREPARAMETERS: Optional. Default boolean (true or false) to only use providers supporting all specified request parameters. Overridden by provider.requireparameters argument. (Phase 2)
OPENROUTERPROVIDERDATACOLLECTION: Optional. Default data collection policy ("allow" or "deny"). Overridden by provider.datacollection argument. (Phase 2)
OPENROUTERPROVIDERALLOWFALLBACKS: Optional. Default boolean (true or false) to control fallback behavior if preferred providers fail. Overridden by provider.allowfallbacks argument. (Phase 2)
env
# Example .env file content
OPENROUTERAPIKEY=your-api-key-here
OPENROUTERDEFAULTMODEL=openrouter/auto
OPENROUTERMAXTOKENS=1024
OPENROUTERPROVIDERQUANTIZATIONS=fp16,int8
OPENROUTERPROVIDERIGNORE=openai,anthropic
OPENROUTERPROVIDERSORT=price
OPENROUTERPROVIDERORDER='["openai/gpt-4o", "anthropic/claude-3-opus"]'
OPENROUTERPROVIDERREQUIREPARAMETERS=true
OPENROUTERPROVIDERDATACOLLECTION=deny
OPENROUTERPROVIDERALLOWFALLBACKS=false
OPENROUTERPROVIDERQUANTIZATIONS=fp16,int8
OPENROUTERPROVIDERIGNORE=openai,anthropic
### Setup
Add to your MCP settings configuration file (clinemcpsettings.json or claudedesktopconfig.json):
json
"mcpServers": {
"openrouterai": {
"command": "npx",
"args": ["@mcpservers/openrouterai"],
## Features
Model Access
Direct access to all OpenRouter.ai models
Automatic model validation and capability checking
Default model configuration support
Performance Optimization
Smart model information caching (1-hour expiry)
Automatic rate limit management
Exponential backoff for failed requests
Unified Response Format
Consistent ToolResult structure for all responses
Clear error identification with isError flag
Structured error messages with context
## Installation
bash
pnpm install @mcpservers/openrouterai
## Configuration
### Prerequisites
1. Get your OpenRouter API key from OpenRouter Keys
2. Choose a default model (optional)
### Environment Variables
OPENROUTERAPIKEY: Required. Your OpenRouter API key.
OPENROUTERDEFAULTMODEL: Optional. The default model to use if not specified in the request (e.g., openrouter/auto).
OPENROUTERMAXTOKENS: Optional. Default maximum number of tokens to generate if maxtokens is not provided in the request.
OPENROUTERPROVIDERQUANTIZATIONS: Optional. Comma-separated list of default quantization levels to filter by (e.g., fp16,int8) if provider.quantizations is not provided in the request. (Phase 1)
OPENROUTERPROVIDERIGNORE: Optional. Comma-separated list of default provider names to ignore (e.g., mistralai,openai) if provider.ignore is not provided in the request. (Phase 1)
OPENROUTERPROVIDERSORT: Optional. Default sort order for providers ("price", "throughput", or "latency"). Overridden by provider.sort argument. (Phase 2)
OPENROUTERPROVIDERORDER: Optional. Default prioritized list of provider IDs (JSON array string, e.g., '["openai/gpt-4o", "anthropic/claude-3-opus"]'). Overridden by provider.order argument. (Phase 2)
OPENROUTERPROVIDERREQUIREPARAMETERS: Optional. Default boolean (true or false) to only use providers supporting all specified request parameters. Overridden by provider.requireparameters argument. (Phase 2)
OPENROUTERPROVIDERDATACOLLECTION: Optional. Default data collection policy ("allow" or "deny"). Overridden by provider.datacollection argument. (Phase 2)
OPENROUTERPROVIDERALLOWFALLBACKS: Optional. Default boolean (true or false) to control fallback behavior if preferred providers fail. Overridden by provider.allowfallbacks argument. (Phase 2)
env
# Example .env file content
OPENROUTERAPIKEY=your-api-key-here
OPENROUTERDEFAULTMODEL=openrouter/auto
OPENROUTERMAXTOKENS=1024
OPENROUTERPROVIDERQUANTIZATIONS=fp16,int8
OPENROUTERPROVIDERIGNORE=openai,anthropic
OPENROUTERPROVIDERSORT=price
OPENROUTERPROVIDERORDER='["openai/gpt-4o", "anthropic/claude-3-opus"]'
OPENROUTERPROVIDERREQUIREPARAMETERS=true
OPENROUTERPROVIDERDATACOLLECTION=deny
OPENROUTERPROVIDERALLOWFALLBACKS=false
OPENROUTERPROVIDERQUANTIZATIONS=fp16,int8
OPENROUTERPROVIDERIGNORE=openai,anthropic
### Setup
Add to your MCP settings configuration file (clinemcpsettings.json or claudedesktopconfig.json):
json
"mcpServers": {
"openrouterai": {
"command": "npx",
"args": ["@mcpservers/openrouterai"],
Listed badge (optional)
Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.
[](https://anclum.com/en/s/heltonteixeira-openrouterai/)
- Source
- awesome · https://github.com/heltonteixeira/openrouterai
- Browse by field
- MCP servers
- Listed by
- 10 independent sources
- added
- today
More like this
Filed under
Every tag opens the full list for that filter. Counts are the live catalogue figures.