Openrouter MCP Multimodal MCP Server

by stabganio.github.stabgan/openrouter-multimodalv4.5.1

Multimodal access to OpenRouter models: text chat, image, audio and video analysis, and image, audio and video generation (Veo, Sora, Seedance, Wan).

96Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active2d ago

Install Openrouter MCP Multimodal MCP server

claude mcp add openrouter-mcp-multimodal -e OPENROUTER_API_KEY='<openrouter-api-key>' -- npx -y @stabgan/openrouter-mcp-multimodal

{
  "mcpServers": {
    "openrouter-mcp-multimodal": {
      "command": "npx",
      "args": [
        "-y",
        "@stabgan/openrouter-mcp-multimodal"
      ],
      "env": {
        "OPENROUTER_API_KEY": "<openrouter-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "openrouter-mcp-multimodal": {
      "command": "npx",
      "args": [
        "-y",
        "@stabgan/openrouter-mcp-multimodal"
      ],
      "env": {
        "OPENROUTER_API_KEY": "<openrouter-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "openrouter-mcp-multimodal": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@stabgan/openrouter-mcp-multimodal"
      ],
      "env": {
        "OPENROUTER_API_KEY": "<openrouter-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "openrouter-mcp-multimodal": {
      "command": "npx",
      "args": [
        "-y",
        "@stabgan/openrouter-mcp-multimodal"
      ],
      "env": {
        "OPENROUTER_API_KEY": "<openrouter-api-key>"
      }
    }
  }
}

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

Configuration

Variable	Required	Secret	Description
OPENROUTER_API_KEY	yes	yes	OpenRouter API key. Get one free at https://openrouter.ai/keys
OPENROUTER_DEFAULT_MODEL	—	—	Default model for chat + analyze tools. Defaults to nvidia/nemotron-nano-12b-v2-vl:free.
OPENROUTER_OUTPUT_DIR	—	—	Sandbox root for save_path on generate_* tools. Defaults to the current working directory.
OPENROUTER_MAX_TOKENS	—	—	Default max_tokens for chat_completion when unset in the request.
OPENROUTER_PROVIDER_SORT	—	—	price / throughput / latency
OPENROUTER_PROVIDER_IGNORE	—	—	CSV of provider slugs to exclude.
OPENROUTER_PROVIDER_ORDER	—	—	JSON array or CSV of preferred provider IDs.
OPENROUTER_PROVIDER_QUANTIZATIONS	—	—	CSV of quantization levels (fp16,int8).
OPENROUTER_PROVIDER_REQUIRE_PARAMETERS	—	—	true/false. Require providers to support all request params.
OPENROUTER_PROVIDER_DATA_COLLECTION	—	—	allow/deny
OPENROUTER_PROVIDER_ALLOW_FALLBACKS	—	—	true/false
OPENROUTER_CACHE_RESPONSES	—	—	Enable response caching server-wide. Sends X-OpenRouter-Cache: true on every chat/analyze call unless overridden per-request. Zero tokens billed on cache hits.
OPENROUTER_INCLUDE_REASONING	—	—	Enable reasoning tokens passthrough server-wide. Adds _meta.reasoning to chat_completion responses for DeepSeek R1 / Gemini Thinking / Opus 4.7.

Freshness

Active — last maintenance signal 2d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-07 · 2d ago · GitHub
Latest release
2026-09-05 · 34d ago · GitHub · v5.0.1
Package published
no data · npm/PyPI
Registry entry updated
2026-05-04 · 5mo ago · official registry · v4.5.1

FAQ

›How do I install the Openrouter MCP Multimodal MCP server in Claude Code?

Run: claude mcp add openrouter-mcp-multimodal -e OPENROUTER_API_KEY='<openrouter-api-key>' -- npx -y @stabgan/openrouter-mcp-multimodal. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Openrouter MCP Multimodal require an API key?

Yes. It expects OPENROUTER_API_KEY, of which 1 is a secret.

›Can I use Openrouter MCP Multimodal as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Openrouter MCP Multimodal in the official MCP registry?

Yes, as io.github.stabgan/openrouter-multimodal.