Integrates OpenRouter.ai so agents can call a range of AI models through one interface.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add openrouter --env OPENROUTER_API_KEY='<OPENROUTER_API_KEY>' --env OPENROUTER_DEFAULT_MODEL='<OPENROUTER_DEFAULT_MODEL>' -- npx @mcpservers/openrouterai~/.codex/config.toml
[mcp_servers.openrouter]
command = "npx"
args = ["@mcpservers/openrouterai"]
env = { OPENROUTER_API_KEY = "<OPENROUTER_API_KEY>", OPENROUTER_DEFAULT_MODEL = "<OPENROUTER_DEFAULT_MODEL>" }
# codex mcp add openrouter --env OPENROUTER_API_KEY='<OPENROUTER_API_KEY>' --env OPENROUTER_DEFAULT_MODEL='<OPENROUTER_DEFAULT_MODEL>' -- npx @mcpservers/openrouterai~/.cursor/mcp.json
{
"mcpServers": {
"openrouter": {
"command": "npx",
"args": [
"@mcpservers/openrouterai"
],
"env": {
"OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>",
"OPENROUTER_DEFAULT_MODEL": "<OPENROUTER_DEFAULT_MODEL>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"openrouter": {
"type": "stdio",
"command": "npx",
"args": [
"@mcpservers/openrouterai"
],
"env": {
"OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>",
"OPENROUTER_DEFAULT_MODEL": "<OPENROUTER_DEFAULT_MODEL>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"openrouter": {
"command": "npx",
"args": [
"@mcpservers/openrouterai"
],
"env": {
"OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>",
"OPENROUTER_DEFAULT_MODEL": "<OPENROUTER_DEFAULT_MODEL>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"openrouter": {
"command": "npx",
"args": [
"@mcpservers/openrouterai"
],
"env": {
"OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>",
"OPENROUTER_DEFAULT_MODEL": "<OPENROUTER_DEFAULT_MODEL>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"openrouter": {
"command": "npx",
"args": [
"@mcpservers/openrouterai"
],
"env": {
"OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>",
"OPENROUTER_DEFAULT_MODEL": "<OPENROUTER_DEFAULT_MODEL>"
}
}
}
}Environment variables
OPENROUTER_API_KEYOPENROUTER_DEFAULT_MODEL
Replace the placeholders with your own credentials and keep them out of version control.