Skip to content
appsgit

Openrouter Multimodal

Openrouter Multimodal is an MCP server that adds cloud and DevOps tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Chat with 300+ LLMs via OpenRouter. Analyze and generate images, audio, and video from MCP. It has 101 GitHub stars, is released under the Apache-2.0 license and runs locally with npx -y @stabgan/openrouter-mcp-multimodal.

github.com/stabgan/openrouter-mcp-multimodal (opens in a new tab)

Data as of from the GitHub API and the official MCP registry; description from the project's repository. Report an error

Install Openrouter Multimodal

Generated from the server's MCP registry entry. Replace your-value with your own values.

Claude Desktop

claude_desktop_config.json
{
  "mcpServers": {
    "openrouter-multimodal": {
      "command": "npx",
      "args": [
        "-y",
        "@stabgan/openrouter-mcp-multimodal"
      ],
      "env": {
        "OPENROUTER_API_KEY": "your-value",
        "OPENROUTER_MAX_TOKENS": "your-value"
      }
    }
  }
}

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

Claude Code

claude mcp add --env OPENROUTER_API_KEY=your-value --env OPENROUTER_MAX_TOKENS=your-value --transport stdio openrouter-multimodal -- npx -y @stabgan/openrouter-mcp-multimodal

Cursor

.cursor/mcp.json
{
  "mcpServers": {
    "openrouter-multimodal": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@stabgan/openrouter-mcp-multimodal"
      ],
      "env": {
        "OPENROUTER_API_KEY": "your-value",
        "OPENROUTER_MAX_TOKENS": "your-value"
      }
    }
  }
}

Project file; use ~/.cursor/mcp.json to enable it in every project.

VS Code

.vscode/mcp.json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "openrouter_api_key",
      "description": "OPENROUTER_API_KEY",
      "password": true
    },
    {
      "type": "promptString",
      "id": "openrouter_max_tokens",
      "description": "OPENROUTER_MAX_TOKENS",
      "password": true
    }
  ],
  "servers": {
    "openrouter-multimodal": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@stabgan/openrouter-mcp-multimodal"
      ],
      "env": {
        "OPENROUTER_API_KEY": "${input:openrouter_api_key}",
        "OPENROUTER_MAX_TOKENS": "${input:openrouter_max_tokens}"
      }
    }
  }
}

Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).

Environment variables

Variables the server reads at startup.

NameRequiredDescription
OPENROUTER_API_KEYsecretYesOpenRouter API key. Get one free at https://openrouter.ai/keys
OPENROUTER_DEFAULT_MODELNoDefault model for chat + analyze tools. Defaults to nvidia/nemotron-nano-12b-v2-vl:free.
OPENROUTER_OUTPUT_DIRNoSandbox root for savepath on generate tools. Defaults to the current working directory.
OPENROUTER_MAX_TOKENSsecretNoDefault maxtokens for chatcompletion when unset in the request.
OPENROUTER_PROVIDER_SORTNoprice / throughput / latency
OPENROUTER_PROVIDER_IGNORENoCSV of provider slugs to exclude.
OPENROUTER_PROVIDER_ORDERNoJSON array or CSV of preferred provider IDs.
OPENROUTER_PROVIDER_QUANTIZATIONSNoCSV of quantization levels (fp16,int8).
OPENROUTER_PROVIDER_REQUIRE_PARAMETERSNotrue/false. Require providers to support all request params.
OPENROUTER_PROVIDER_DATA_COLLECTIONNoallow/deny
OPENROUTER_PROVIDER_ALLOW_FALLBACKSNotrue/false
OPENROUTER_CACHE_RESPONSESNoEnable 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_REASONINGNoEnable reasoning tokens passthrough server-wide. Adds meta.reasoning to chatcompletion responses for DeepSeek R1 / Gemini Thinking / Opus 4.7.

Tools (22)

Parsed from the Tools section of the README; check the repository for the current list.

  • chat_completion

    Text chat, web search, provider routing, caching, reasoning, structured output

  • start_chat_completion

    Async background job for long-running reasoning models

  • get_chat_completion_status

    Poll / retrieve async completion results

  • analyze_image

    Vision — local path, URL, or data URL + question

  • analyze_audio

    Transcribe / analyze audio files

  • analyze_video

    Describe / Q&A over video files

  • generate_image

    Text-to-image via chat completions with reference images

  • generate_image_dedicated

    Text-to-image via dedicated /api/v1/images (resolution, quality, format)

  • generate_audio

    Text-to-speech / music via chat completions

  • text_to_speech

    Dedicated TTS (/api/v1/audio/speech) — Deepgram, ElevenLabs, OpenAI; voices, speed, mp3/pcm

  • speech_to_text

    Dedicated STT (/api/v1/audio/transcriptions) — Whisper, GPT-4o Transcribe, Voxtral, ElevenLabs Scribe

  • generate_video

    Text-to-video (async, resumable)

  • generate_video_from_image

    Image-to-video (narrower schema)

  • get_video_status

    Poll / resume video jobs

  • search_models

    Paginated model catalog search

  • get_model_info

    Pricing, context, modalities

  • validate_model

    Cheap model ID existence check

  • rerank_documents

    Relevance ranking for RAG

  • embed_text

    Vector embeddings (37+ models: text-embedding-3-small/large, Nomic, etc.)

  • decide

    Structured decisions with calibrated probabilities (System One models)

  • health_check

    API key + reachability probe

  • save_path

    Tool result

About Openrouter Multimodal

The MCP server for multimodal AI agents. One install · 21 tools · 300+ OpenRouter models · text, vision, audio & video — analysis and generation.

  • claude
  • llm
  • mcp
  • mcp-server
  • model-context-protocol
  • multimodal
  • openrouter
  • typescript
  • docker
  • image-generation

FAQ

Openrouter Multimodal FAQ

Still curious? Email info@appsgit.com.

How do I install the Openrouter Multimodal MCP server?

Add the command npx -y @stabgan/openrouter-mcp-multimodal to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.

Is Openrouter Multimodal free?

The server is open source under the Apache-2.0 license, so running it is free. It needs credentials (OPENROUTER_API_KEY and OPENROUTER_MAX_TOKENS) for the service it connects to, which may require a paid account.

Is Openrouter Multimodal actively maintained?

The most recent commit was on Oct 24, 2026. The latest release is v5.1.3, published Oct 22, 2026. appsgit only lists MCP servers with a commit in the last six months.