Skip to content
MCP server

OpenRouter

MCP server providing access to 300+ AI models via OpenRouter

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
1.1.8
Listing updated
5 days ago

About OpenRouter

OpenRouter is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add mcp-openrouter --env OPENROUTER_API_KEY='<OPENROUTER_API_KEY>' -- uvx mcp-openrouter

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-openrouter": {
      "command": "uvx",
      "args": [
        "mcp-openrouter"
      ],
      "env": {
        "OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-openrouter": {
      "command": "uvx",
      "args": [
        "mcp-openrouter"
      ],
      "env": {
        "OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-openrouter": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-openrouter"
      ],
      "env": {
        "OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-openrouter": {
      "command": "uvx",
      "args": [
        "mcp-openrouter"
      ],
      "env": {
        "OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp-openrouter": {
      "command": "uvx",
      "args": [
        "mcp-openrouter"
      ],
      "env": {
        "OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>"
      }
    }
  }
}

Configuration

  • OPENROUTER_API_KEYOpenRouter API key used to authenticate tool requests.Required
  • DEFAULT_TEXT_MODELDefault model slug for chat tool calls when no model is provided.
  • DEFAULT_IMAGE_MODELDefault model slug for image generation tool calls.
  • DEFAULT_CODE_MODELDefault model slug for code-oriented tasks.
  • DEFAULT_VISION_MODELDefault model slug for vision-capable tool calls.
  • DEFAULT_EMBEDDING_MODELDefault model slug for embedding tool calls when no model is provided.

Pricing

Open source

OpenRouter FAQ

Is OpenRouter free?

Yes. OpenRouter is open source, so you can use and self-host it for free.

How do I add OpenRouter to Claude Code?

Run this command in your terminal: claude mcp add mcp-openrouter --env OPENROUTER_API_KEY='<OPENROUTER_API_KEY>' -- uvx mcp-openrouter