OpenRouter MCP Server

A Model Context Protocol (MCP) server that provides access to OpenRouter's extensive collection of 400+ AI models through Claude.

Features

• 🤖 Access to 400+ language models including GPT-4, Claude, Gemini, Llama, and more
• 🔍 List and search available models with pricing information
• 💬 Chat with any model through a unified interface
• 🔄 Compare responses from multiple models side-by-side
• 📊 Get detailed model information including context limits and capabilities
• 📄 NEW: Parallel document analysis with smart chunking and synthesis
• 🔧 Seamless integration with Claude Desktop and Claude Code

Installation

# Clone the repository
git clone https://github.com/th3nolo/openrouter-mcp.git
cd openrouter-mcp

# Install dependencies
npm install
# or
yarn install

# Build the TypeScript code
npm run build
# or
yarn build

Configuration

1. Get your OpenRouter API key from OpenRouter
2. Copy .env.example to .env:

   cp .env.example .env
   

3. Edit .env and add your API key:

   OPENROUTER_API_KEY=your_api_key_here
   

Usage

Available MCP Tools

• list_models - Get a list of all available models with pricing
• chat_with_model - Send a message to a specific model
  • Parameters: model, message, max_tokens, temperature, system_prompt
• compare_models - Compare responses from multiple models
  • Parameters: models[], message, max_tokens
• get_model_info - Get detailed information about a specific model
  • Parameters: model
• analyze_document - Analyze large documents using parallel processing
  • Parameters: document, query, analysis_type (search/summarize/extract/qa), chunk_size, parallel_instances
  • Default model: google/gemma-3n-e4b-it (optimized for cost and performance)

Available MCP Resources

• openrouter://models - List of all available models with pricing
• openrouter://pricing - Current pricing information for all models
• openrouter://usage - Your OpenRouter usage statistics

Claude Code Integration

Add the server to Claude Code:

claude mcp add openrouter -s user \
  -e OPENROUTER_API_KEY=your_api_key_here \
  -- node /path/to/openrouter-mcp/dist/server.js

Or add it manually to your Claude Desktop configuration:

{
  "mcpServers": {
    "openrouter": {
      "command": "node",
      "args": ["/path/to/openrouter-mcp/dist/server.js"],
      "env": {
        "OPENROUTER_API_KEY": "your_api_key_here"
      }
    }
  }
}

Example Usage

Once configured, you can use these commands in Claude:

"List all available Gemma models"
"Chat with gpt-4 and ask it to explain quantum computing"
"Compare responses from claude-3-opus and gpt-4 about climate change"
"Get detailed information about google/gemini-pro"
"Analyze this document and extract all key dates and milestones"
"Search this research paper for information about methodology"
"Summarize this 100-page report focusing on recommendations"

Document Analysis Examples

The new analyze_document tool supports:

• Summarization: Create comprehensive summaries of large documents
• Search: Find specific information across document sections
• Extraction: Extract structured data like dates, names, or custom targets
• Q&A: Answer multiple questions about document content

Example: Analyzing a 100K character document costs only ~$0.0005 using Gemma!

Development

# Run in development mode
npm run dev

# Run tests
npm test

# Lint code
npm run lint

# Type check
npm run typecheck

Environment Variables

• OPENROUTER_API_KEY - Your OpenRouter API key (required)
• OPENROUTER_BASE_URL - API base URL (default: https://openrouter.ai/api/v1)
• OPENROUTER_SITE_URL - Your site URL for API attribution
• OPENROUTER_APP_NAME - Application name for API headers

Security

• API keys are stored in environment variables only
• The .env file is excluded from version control
• Never commit your API keys to the repository

License

MIT

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.