heltonteixeira/openrouterai

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"],