MCP Server

OpenRouter MCP Server

Name: OpenRouter MCP Server
Author: io.github.tsilva

io.github.tsilva/mcp-openrouter

Repository Registry

What is the OpenRouter MCP server?

MCP server providing access to 300+ AI models via OpenRouter

How to install OpenRouter

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

OPENROUTER_API_KEY
required
secret
OpenRouter API key used to authenticate tool requests.
DEFAULT_TEXT_MODEL
Default model slug for chat tool calls when no model is provided.
DEFAULT_IMAGE_MODEL
Default model slug for image generation tool calls.
DEFAULT_CODE_MODEL
Default model slug for code-oriented tasks.
DEFAULT_VISION_MODEL
Default model slug for vision-capable tool calls.
DEFAULT_EMBEDDING_MODEL
Default model slug for embedding tool calls when no model is provided.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-openrouter": {
      "command": "uvx",
      "args": [
        "mcp-openrouter"
      ],
      "env": {
        "OPENROUTER_API_KEY": "<YOUR_OPENROUTER_API_KEY>",
        "DEFAULT_TEXT_MODEL": "<YOUR_DEFAULT_TEXT_MODEL>",
        "DEFAULT_IMAGE_MODEL": "<YOUR_DEFAULT_IMAGE_MODEL>",
        "DEFAULT_CODE_MODEL": "<YOUR_DEFAULT_CODE_MODEL>",
        "DEFAULT_VISION_MODEL": "<YOUR_DEFAULT_VISION_MODEL>",
        "DEFAULT_EMBEDDING_MODEL": "<YOUR_DEFAULT_EMBEDDING_MODEL>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-openrouter": {
      "command": "uvx",
      "args": [
        "mcp-openrouter"
      ],
      "env": {
        "OPENROUTER_API_KEY": "<YOUR_OPENROUTER_API_KEY>",
        "DEFAULT_TEXT_MODEL": "<YOUR_DEFAULT_TEXT_MODEL>",
        "DEFAULT_IMAGE_MODEL": "<YOUR_DEFAULT_IMAGE_MODEL>",
        "DEFAULT_CODE_MODEL": "<YOUR_DEFAULT_CODE_MODEL>",
        "DEFAULT_VISION_MODEL": "<YOUR_DEFAULT_VISION_MODEL>",
        "DEFAULT_EMBEDDING_MODEL": "<YOUR_DEFAULT_EMBEDDING_MODEL>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-openrouter": {
      "command": "uvx",
      "args": [
        "mcp-openrouter"
      ],
      "env": {
        "OPENROUTER_API_KEY": "<YOUR_OPENROUTER_API_KEY>",
        "DEFAULT_TEXT_MODEL": "<YOUR_DEFAULT_TEXT_MODEL>",
        "DEFAULT_IMAGE_MODEL": "<YOUR_DEFAULT_IMAGE_MODEL>",
        "DEFAULT_CODE_MODEL": "<YOUR_DEFAULT_CODE_MODEL>",
        "DEFAULT_VISION_MODEL": "<YOUR_DEFAULT_VISION_MODEL>",
        "DEFAULT_EMBEDDING_MODEL": "<YOUR_DEFAULT_EMBEDDING_MODEL>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "mcp-openrouter": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-openrouter"
      ],
      "env": {
        "OPENROUTER_API_KEY": "<YOUR_OPENROUTER_API_KEY>",
        "DEFAULT_TEXT_MODEL": "<YOUR_DEFAULT_TEXT_MODEL>",
        "DEFAULT_IMAGE_MODEL": "<YOUR_DEFAULT_IMAGE_MODEL>",
        "DEFAULT_CODE_MODEL": "<YOUR_DEFAULT_CODE_MODEL>",
        "DEFAULT_VISION_MODEL": "<YOUR_DEFAULT_VISION_MODEL>",
        "DEFAULT_EMBEDDING_MODEL": "<YOUR_DEFAULT_EMBEDDING_MODEL>"
      }
    }
  }
}

Claude Code

claude mcp add mcp-openrouter --env OPENROUTER_API_KEY=<YOUR_OPENROUTER_API_KEY> --env DEFAULT_TEXT_MODEL=<YOUR_DEFAULT_TEXT_MODEL> --env DEFAULT_IMAGE_MODEL=<YOUR_DEFAULT_IMAGE_MODEL> --env DEFAULT_CODE_MODEL=<YOUR_DEFAULT_CODE_MODEL> --env DEFAULT_VISION_MODEL=<YOUR_DEFAULT_VISION_MODEL> --env DEFAULT_EMBEDDING_MODEL=<YOUR_DEFAULT_EMBEDDING_MODEL> -- uvx mcp-openrouter