gexbot-mcp

Ein schlanker MCP-Server, der die GEXBot API kapselt, sodass er als benutzerdefinierter Connector in claude.ai hinzugefügt werden kann.

Erstellt mit dem offiziellen MCP Python SDK (FastMCP), bereitgestellt über Streamable HTTP, sodass er remote gehostet werden kann (z. B. auf Render).

Spezifikationsreferenz: nfa-llc/gexbot-openapi — Basis-URL https://api.gex.bot/v2, Bearer-Token-Authentifizierung.

Bereitgestellte Tools

Zusätzlich gibt es einen einfachen HTTP-GET /health-Endpunkt (kein MCP-Tool) für Uptime-Checks / Render-Health-Checks.

Über dte

GEXBot akzeptiert keine beliebige DTE-Ganzzahl – es gruppiert Daten in feste Kategorien. Dieser Server bildet das dte-Argument auf diese Kategorien ab:

• dte=0 → zero (nächstes Verfallsdatum / 0DTE)

• dte=1 → one (nächstes Verfallsdatum + 1)

• jeder andere Wert → full (vollständige Aggregation über alle veröffentlichten Verfallsdaten, bis zu ~90 Tage im Voraus)

Relevante Ticker

Keine fest codierte Einschränkung – jeder Ticker, den GEXBot unterstützt, funktioniert (siehe list_tickers()). Diejenigen, die Sie wahrscheinlich am häufigsten verwenden: QQQ, SPY, NDX, SPX, SPXW.

Related MCP server: ai-trader

Authentifizierung

Der Server liest GEXBOT_API_KEY zur Anfragezeit aus der Umgebung und sendet ihn als Authorization: Bearer <key> an GEXBot. Der Schlüssel ist niemals fest codiert – er muss als Umgebungsvariable gesetzt werden, wo immer Sie dies ausführen (lokal, in Docker oder auf Render).

Lokal ausführen

python -m venv .venv
.venv\Scripts\activate        # Windows
pip install -r requirements.txt

set GEXBOT_API_KEY=gexbot_custom_your_key_here   # cmd.exe
# or: $env:GEXBOT_API_KEY = "gexbot_custom_your_key_here"   # PowerShell

python server.py

Der Server lauscht standardmäßig auf http://0.0.0.0:8000 (überschreibbar mit PORT). Der MCP-Endpunkt befindet sich unter /mcp; der Health-Check unter /health.

Kurzer Funktionstest:

curl http://localhost:8000/health

Mit Docker ausführen

docker build -t gexbot-mcp .
docker run -p 8000:8000 -e GEXBOT_API_KEY=gexbot_custom_your_key_here gexbot-mcp

Auf Render bereitstellen (kostenloser Tarif)

1. Übertragen Sie diesen Ordner in ein GitHub- (oder GitLab-)Repository.

2. Im Render-Dashboard: New + → Web Service → verbinden Sie Ihr Repository.

   • Render erkennt die Dockerfile automatisch. Lassen Sie Build-/Startbefehle leer (Docker übernimmt das).

   • Oder, wenn Sie eine Ein-Klick-Konfiguration bevorzugen, enthält dieses Repository render.yaml – verwenden Sie stattdessen New + → Blueprint und zeigen Sie auf das Repository.

3. Setzen Sie den Instance Type auf Free.

4. Unter Environment fügen Sie hinzu:

   • GEXBOT_API_KEY = Ihr Schlüssel (markieren Sie ihn als Secret). Fügen Sie dies selbst im Render-Dashboard ein – setzen Sie es nicht in das Repository oder in render.yaml.

5. Health Check Path: /health.

6. Bereitstellen. Render erstellt das Docker-Image und gibt Ihnen eine URL wie: https://gexbot-mcp.onrender.com

Hinweis: Render's kostenlose Webdienste fahren nach 15 Minuten Inaktivität herunter und benötigen ~30-60s, um bei der nächsten Anfrage wieder aufzuwachen – der erste Tool-Aufruf nach einer Leerlaufzeit kann langsam sein.

Zu claude.ai als benutzerdefinierter Connector hinzufügen

1. In claude.ai: Settings → Connectors → Add custom connector.

2. URL: https://<your-app>.onrender.com/mcp

3. Speichern. Claude wird die drei Tools erkennen (get_gex_levels, get_gex_profile, list_tickers).

Fehlerbehandlung

Alle Tools geben ein kompaktes JSON-Dict zurück. Bei einem Fehler geben sie {"error": "<message>", ...} zurück, anstatt eine Ausnahme auszulösen, sodass das Modell das Problem sehen und weitergeben kann. Behandelte Fälle:

• Ungültiger/fehlender API-Schlüssel → 401 von GEXBot → klare Meldung „GEXBOT_API_KEY überprüfen“.

• Schlüssel hat keinen Zugriff auf eine Ressource → 403 → klare Meldung.

• Nicht unterstützter Ticker → 404 → klare Meldung.

• Ungültige Anfrage (z. B. fehlerhafter Ticker/Kategorie) → 400 → GEXBots Fehlermeldung wird angezeigt.

• GEXBot-Ausfall / Randfälle bei geschlossenem Markt → 5xx wird mit einer klaren Meldung behandelt; zusätzlich enthalten get_gex_levels / get_gex_profile ein "stale": true-Flag, wenn der Zeitstempel der zurückgegebenen Daten älter als 24 Stunden ist, da GEXBot selbst keinen expliziten Fehler „Markt geschlossen“ hat.

• Netzwerk-/Timeout-Fehler → klare Meldung, kein Stack-Trace wird an den Client weitergegeben.

Projektstruktur

server.py         # the MCP server (FastMCP, Streamable HTTP)
requirements.txt
Dockerfile
render.yaml        # optional Render Blueprint config
.env.example