OpenRouter MCP-Server

MCP-Server (Model Context Protocol) zum Entdecken und Abfragen von über 300 KI-Modellen, die auf OpenRouter verfügbar sind.

Funktionen

• Modelle auflisten — Durchsuchen Sie alle verfügbaren Modelle mit Preisen, Kontextlimits und Fähigkeiten

• Suchen & Filtern — Finden Sie Modelle nach Anbieter, Preis, Kontextlänge, Funktionen (Tools, Vision, etc.)

• Modelle vergleichen — Direkter Vergleich mehrerer Modelle

• Details abrufen — Vollständige Metadaten für jedes spezifische Modell

• Zwischengespeicherte Antworten — 5-Minuten-Cache zur Reduzierung von API-Aufrufen

Installation

pip install openrouter-mcp

Verwendung

Mit OpenClaw

Fügen Sie dies zur MCP-Server-Konfiguration in Ihrer openclaw.json hinzu:

{
  "mcp": {
    "servers": {
      "openrouter-models": {
        "command": "openrouter-mcp",
        "env": {
          "OPENROUTER_API_KEY": "your-api-key"
        }
      }
    }
  }
}

Starten Sie anschließend das Gateway neu. Agenten können nun die MCP-Tools verwenden, um OpenRouter-Modelle abzufragen.

Hinweis: OPENROUTER_API_KEY ist optional, wird aber für höhere Ratenlimits empfohlen (200 Anfragen/Min. statt 20 Anfragen/Min.). Holen Sie sich Ihren Schlüssel unter: https://openrouter.ai/keys

Beispiel für die Verwendung durch einen Agenten:

# Agent can now call MCP tools like:
list_models(sort_by="context_length")
search_models(query="claude", max_input_price=5.0)
get_model(model_id="anthropic/claude-sonnet-4.6")
compare_models(model_ids="qwen/qwen3.6-plus,anthropic/claude-sonnet-4.6")

Standalone (stdio)

export OPENROUTER_API_KEY=your-key
python -m openrouter_mcp.server

Verfügbare Tools

Beispiele

Modelle sortiert nach Kontextlänge auflisten

{
  "name": "list_models",
  "arguments": {
    "modality": "text",
    "sort_by": "context_length"
  }
}

Nach Claude-Modellen unter $5/1M Token suchen

{
  "name": "search_models",
  "arguments": {
    "query": "claude",
    "provider": "anthropic",
    "max_input_price": 5.0,
    "requires_tools": true
  }
}

3 Modelle vergleichen

{
  "name": "compare_models",
  "arguments": {
    "model_ids": "anthropic/claude-sonnet-4.6,qwen/qwen3.6-plus,openai/gpt-5.4"
  }
}

Modelldetails abrufen

{
  "name": "get_model",
  "arguments": {
    "model_id": "anthropic/claude-sonnet-4.6"
  }
}

API-Referenz

list_models(modality, sort_by)

• modality (str, Standard: "text"): Filtern nach Ausgabetyp. Optionen: text, image, audio, embeddings, all

• sort_by (str, Standard: "name"): Sortieren nach: name, created, price, context_length

get_model(model_id)

• model_id (str, erforderlich): Modell-Slug, z. B. anthropic/claude-sonnet-4.6

search_models(query, provider, max_input_price, min_context, requires_tools, requires_vision, free_only)

• query (str): Freitextsuche in Modellname/ID/Beschreibung

• provider (str): Filtern nach Anbieter (z. B. anthropic, google, openai)

• max_input_price (float): Maximaler Eingabepreis pro 1M Token (0 = kein Limit)

• min_context (int): Minimale Kontextfenstergröße

• requires_tools (bool): Nur Modelle, die Tool-Calling unterstützen

• requires_vision (bool): Nur Modelle mit Vision/Bildeingabe

• free_only (bool): Nur kostenlose Modelle

compare_models(model_ids)

• model_ids (str, erforderlich): Kommagetrennte Liste von Modell-IDs

refresh_cache()

Erzwingt eine Aktualisierung des Modell-Caches von der OpenRouter-API.

Ratenlimits

• Ohne API-Schlüssel: 20 Anfragen/Minute

• Mit API-Schlüssel: 200 Anfragen/Minute

• Modelldaten werden für 5 Minuten zwischengespeichert

Holen Sie sich Ihren API-Schlüssel unter: https://openrouter.ai/keys

Lizenz

MIT

Mitwirken

Beiträge sind willkommen! Bitte eröffnen Sie ein Issue oder einen PR auf GitHub.