openrouter-mcp

MCP server for consulting AI models via OpenRouter. Designed for AI assistants like Claude Code to ask other models for help.

Installation

npm install -g openrouter-mcp

Configuration

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | OPENROUTER_API_KEY | Yes | Your OpenRouter API key | | OPENROUTER_ALLOWED_MODELS | Yes | Comma-separated list of allowed model IDs | | OPENROUTER_SYSTEM_PROMPT | No | Default system prompt for all requests |

Example MCP Config

{
  "mcpServers": {
    "openrouter": {
      "command": "npx",
      "args": ["-y", "openrouter-mcp"],
      "env": {
        "OPENROUTER_API_KEY": "sk-or-...",
        "OPENROUTER_ALLOWED_MODELS": "anthropic/claude-3.5-sonnet,openai/gpt-4o,google/gemini-2.0-flash-001",
        "OPENROUTER_SYSTEM_PROMPT": "You are helping an AI coding assistant. Be direct and provide code examples when relevant."
      }
    }
  }
}

Tool: ask_model

Consult another AI model for help with coding tasks.

Parameters

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | model | string | Yes | Model ID from the allowed list | | message | string | Yes | Your question or request | | system_prompt | string | No | Override the default system prompt | | append_files | string[] | No | File paths to read and include as context |

Limits

• Max 10 files per request
• Max 150KB per file
• Text files only (no binary)
• 2 minute timeout per request

License

MIT