QuantData MCP-Server

DIES IST EIN INOFFIZIELLER MCP-SERVER. ICH BIN IN KEINER WEISE MIT QUANTDATA VERBUNDEN.

MCP-Server, der KI-Agenten (Claude Code, Claude Desktop usw.) Zugriff auf Echtzeit- und historische Optionsmarktdaten von QuantData gewährt.

📖 Neu hier? Beginnen Sie mit dem Getting Started Guide für eine Schritt-für-Schritt-Anleitung.

Unterstützt jeden optionsfähigen Ticker — SPX, SPY, QQQ, AAPL, TSLA und mehr. Nicht nur 0DTE.

Verfügbare Daten: GEX/DEX/CEX/VEX Exposure Walls, Exposure Term Structure, Net Drift, Max Pain, IV Rank, Handelsstatistiken, Open Interest, Net Flow, konsolidierter Order Flow, Kontrakt-OHLCV und Kontraktstatistiken.

Dokumentation: Siehe GETTING_STARTED.md für eine Schritt-für-Schritt-Anleitung.

Related MCP server: traders-edge-mcp

Schnellstart

1. Installation

Sie benötigen Python 3.11+. Überprüfen Sie dies mit python3 --version.

• Mac: brew install python (oder Download von python.org)

• Windows: Download von python.org (während der Installation "Add to PATH" aktivieren)

Installation über PyPI:

# With pip
pip install quantdata-mcp

# With uv (faster)
uv pip install quantdata-mcp

# Or install as a global tool with uv
uv tool install quantdata-mcp

Kein uv? Installieren Sie es mit curl -LsSf https://astral.sh/uv/install.sh | sh (Mac/Linux) oder irm https://astral.sh/uv/install.ps1 | iex (Windows). Es ist eine schnellere Alternative zu pip.

Sie wollen die neueste Version? Installation von GitHub: pip install git+https://github.com/zzulanas/quantdata-mcp.git

2. Anmeldedaten abrufen

Sie benötigen zwei Werte aus Ihrem QuantData-Konto. Öffnen Sie Ihren Browser:

1. Gehen Sie zu v3.quantdata.us und melden Sie sich an

2. Öffnen Sie die Entwicklertools (F12 oder Rechtsklick → Untersuchen) → Tab Netzwerk

3. Laden Sie die Seite neu

4. Klicken Sie auf ein beliebiges Diagramm oder eine Seite auf QuantData — Sie werden sehen, wie API-Anfragen erscheinen

5. Klicken Sie auf eine beliebige Anfrage an core-lb-prod.quantdata.us oder filtern Sie oben nach /api

6. Suchen und kopieren Sie in den Request Headers:

   • authorization — Ihr Auth-Token (beginnt mit eyJ...)

   • x-instance-id — Ihre Instanz-ID (eine UUID wie xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)

Sollte wie folgt aussehen:

3. Setup ausführen

quantdata-mcp setup \
  --auth-token "eyJhbGci..." \
  --instance-id "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

Dies erstellt eine dedizierte Seite in Ihrem QuantData-Konto mit 11 Datentools und speichert Ihre Konfiguration unter ~/.quantdata-mcp/config.json.

4. Zu Claude hinzufügen

Claude Code

Fügen Sie dies zur .mcp.json Ihres Projekts (oder zur globalen ~/.claude/mcp.json) hinzu:

{
  "mcpServers": {
    "quantdata": {
      "command": "quantdata-mcp",
      "args": ["serve"]
    }
  }
}

Starten Sie Claude Code neu. Sie sollten quantdata in Ihren MCP-Servern sehen.

Claude Desktop

Fügen Sie dies zu Ihrer Claude Desktop-Konfigurationsdatei hinzu:

• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "quantdata": {
      "command": "quantdata-mcp",
      "args": ["serve"]
    }
  }
}

Hinweis: quantdata-mcp muss sich in Ihrem System-PATH befinden. Wenn es nicht gefunden wird, verwenden Sie den vollständigen Pfad:

which quantdata-mcp   # find the path

{ "command": "/Users/you/.local/bin/quantdata-mcp", "args": ["serve"] }

Oder verwenden Sie uvx, um es auszuführen, ohne sich um den PATH sorgen zu müssen:

{
  "command": "uvx",
  "args": ["--from", "git+https://github.com/zzulanas/quantdata-mcp.git", "quantdata-mcp", "serve"]
}

Starten Sie Claude Desktop neu. Die QuantData-Tools erscheinen in Ihrer Tool-Liste.

Verfügbare Tools

Marktübersicht

Exposure (Greeks)

Premium Flow

Order Flow & Handelsstatistiken

Volatilität & Preisgestaltung

Open Interest & Max Pain

Allgemeine Parameter

Alle Tools akzeptieren diese Parameter zur Ticker-/Datumskontrolle:

Filterparameter

Tools, die Filterung unterstützen, akzeptieren diese optionalen Parameter:

Anwendungsbeispiele

Fragen Sie Claude Dinge wie:

• "Was sind die größten GEX-Walls im Moment?"

• "Zeig mir die DEX-Walls von gestern um 10:30 Uhr"

• "Ruf die Handelsstatistiken ab — sind Puts oder Calls heute aggressiver?"

• "Vergleiche das GEX-Profil bei Eröffnung vs. Schluss für letzten Donnerstag"

• "Zeig mir das AAPL Gamma Exposure für den monatlichen Verfall am 17. April"

• "Was ist der OTM-only Net Drift für SPX heute?"

• "Zeig mir den Order Flow — nur Calls mit einem Premium über $50.000"

• "Hol mir den OHLCV für den SPX 6600 Call heute"

• "Was ist der IV Rank mit einem 30-Tage-Lookback?"

• "Zeig die GEX Term Structure über alle Verfallsdaten"

Multi-Ticker-Unterstützung

Alle Tools funktionieren mit jedem optionsfähigen Ticker. Übergeben Sie einfach ticker="AAPL" (oder das entsprechende Symbol).

Wichtig: SPX, SPY und QQQ haben tägliche Verfallsdaten (0DTE funktioniert standardmäßig). Für Aktienoptionen wie AAPL oder TSLA müssen Sie expiration_date auf ein gültiges Verfallsdatum setzen (z.B. monatlich am 3. Freitag), sonst erhalten Sie leere Daten.

> Show me TSLA GEX walls for the April 17 monthly
> qd_get_exposure_by_strike(ticker="TSLA", expiration_date="2026-04-17")

Historische Daten

Alle Tools unterstützen historische Analysen. Übergeben Sie entweder date= an ein beliebiges Tool oder verwenden Sie qd_set_page_date, um den Kontext zu wechseln:

> Set the date to 2026-03-26 and show me the GEX walls at 10:00 AM

> qd_set_page_date(date="2026-03-26")
> qd_get_exposure_by_strike(greek_type="GAMMA", time_minutes=600)

Zeit-Scrubbing: time_minutes = Minuten ab Mitternacht (570 = 9:30 Uhr, 720 = 12:00 Uhr, 960 = 16:00 Uhr).

Hinweis: date muss ein gültiger Handelstag sein (keine Wochenenden oder Marktfeiertage).

Funktionsweise

QuantData hat keine offizielle API. Dieser Server verwendet Reverse-Engineering der REST-Endpunkte ihrer Web-App. Jeder Benutzer hat "Tools" (Chart-Widgets) auf "Seiten" — der Setup-Befehl erstellt eine dedizierte Seite mit allen 11 Datentypen, damit der MCP-Server sie abfragen kann.

Architektur:

Claude --> MCP (stdio) --> quantdata-mcp server --> QuantData REST API

Ihre Anmeldedaten und Tool-IDs werden lokal unter ~/.quantdata-mcp/config.json gespeichert.

Befehle

quantdata-mcp setup --auth-token <TOKEN> --instance-id <ID>  # One-time setup
quantdata-mcp serve                                           # Start MCP server (used by Claude)

Anforderungen

• Python 3.11+

• Aktives QuantData Abonnement

Fehlerbehebung

"Config not found"-Fehler: Führen Sie zuerst quantdata-mcp setup aus.

Auth-Fehler (401): Ihr Token ist abgelaufen. Holen Sie sich ein neues aus dem Netzwerk-Tab und führen Sie das Setup erneut aus. Ihre bestehende Seite und Tools werden wiederverwendet:

quantdata-mcp setup --auth-token "NEW_TOKEN" --instance-id "SAME_ID"

Leere Daten: Stellen Sie sicher, dass Sie ein aktives QuantData-Abonnement haben und der Markt an dem Datum, das Sie abfragen, geöffnet war. Stellen Sie bei Nicht-Index-Tickern (AAPL, TSLA) sicher, dass Sie expiration_date auf ein gültiges Optionsverfallsdatum setzen.

"No such file or directory" in Claude Desktop: Verwenden Sie den vollständigen Pfad zu quantdata-mcp (siehe Schritt 4 oben).

Mitwirken

Beiträge sind willkommen — Fehlerberichte, neue Tools, die zusätzliche QuantData-Widgets einbinden, Verbesserungen der Formatierung und Dokumentation helfen alle. Siehe CONTRIBUTING.md für das Setup der Entwicklungsumgebung, das Rezept zum Hinzufügen eines neuen MCP-Tools und die Konventionen, die beim Senden eines PR zu befolgen sind.

Lizenz

MIT — siehe LICENSE.