OpenRouter MCP Server

MCP (Model Context Protocol) server for discovering and querying 300+ AI models available on OpenRouter.

Features

List models — Browse all available models with pricing, context limits, and capabilities
Search & filter — Find models by provider, price, context length, features (tools, vision, etc.)
Compare models — Side-by-side comparison of multiple models
Get details — Full metadata for any specific model
Cached responses — 5-minute cache to reduce API calls

Installation

pip install openrouter-mcp

Usage

With OpenClaw

Add to your openclaw.json MCP servers config:

{
  "mcp": {
    "servers": {
      "openrouter-models": {
        "command": "openrouter-mcp",
        "env": {
          "OPENROUTER_API_KEY": "your-api-key"
        }
      }
    }
  }
}

Then restart the gateway. Agents can now use the MCP tools to query OpenRouter models.

Note: OPENROUTER_API_KEY is optional but recommended for higher rate limits (200 req/min vs 20 req/min). Get your key at: https://openrouter.ai/keys

Example agent usage:

# Agent can now call MCP tools like:
list_models(sort_by="context_length")
search_models(query="claude", max_input_price=5.0)
get_model(model_id="anthropic/claude-sonnet-4.6")
compare_models(model_ids="qwen/qwen3.6-plus,anthropic/claude-sonnet-4.6")

Standalone (stdio)

export OPENROUTER_API_KEY=your-key
python -m openrouter_mcp.server

Available Tools

| Tool | Description | |------|-------------| | list_models | List all models with optional modality filter and sorting | | get_model | Get detailed info for a specific model by ID | | search_models | Search and filter models by query, provider, price, context, features | | compare_models | Compare multiple models side by side | | refresh_cache | Force refresh the model cache from OpenRouter API |

Examples

List models sorted by context length

{
  "name": "list_models",
  "arguments": {
    "modality": "text",
    "sort_by": "context_length"
  }
}

Search for Claude models under $5/1M tokens

{
  "name": "search_models",
  "arguments": {
    "query": "claude",
    "provider": "anthropic",
    "max_input_price": 5.0,
    "requires_tools": true
  }
}

Compare 3 models

{
  "name": "compare_models",
  "arguments": {
    "model_ids": "anthropic/claude-sonnet-4.6,qwen/qwen3.6-plus,openai/gpt-5.4"
  }
}

Get model details

{
  "name": "get_model",
  "arguments": {
    "model_id": "anthropic/claude-sonnet-4.6"
  }
}

API Reference

`list_models(modality, sort_by)`

modality (str, default: "text"): Filter by output type. Options: text, image, audio, embeddings, all
sort_by (str, default: "name"): Sort by: name, created, price, context_length

`get_model(model_id)`

model_id (str, required): Model slug, e.g. anthropic/claude-sonnet-4.6

`search_models(query, provider, max_input_price, min_context, requires_tools, requires_vision, free_only)`

query (str): Free-text search in model name/id/description
provider (str): Filter by provider (e.g. anthropic, google, openai)
max_input_price (float): Max input price per 1M tokens (0 = no limit)
min_context (int): Minimum context window size
requires_tools (bool): Only models supporting tool calling
requires_vision (bool): Only models with vision/image input
free_only (bool): Only free models

`compare_models(model_ids)`

model_ids (str, required): Comma-separated list of model IDs

`refresh_cache()`

Force refresh the model cache from OpenRouter API.

Rate Limits

Without API key: 20 requests/minute
With API key: 200 requests/minute
Model data is cached for 5 minutes

Get your API key at: https://openrouter.ai/keys

License

MIT

Contributing

Contributions welcome! Please open an issue or PR on GitHub.

MCP Servers