GammaRips MCP-Server

Options-Flow-Intelligence-Primitive für KI-Agenten.

Jeden Handelstag scannt GammaRips den US-Optionsmarkt auf ungewöhnliche institutionelle Aktivität und kuratiert sie hart – bis auf einen ~50-Namen umfassenden High-Signal-BULLISH-Pool. Dieser MCP-Server gibt einem Trader mit eigenem Agenten diesen Pool plus die Grundlage, um darüber zu reasoning: Point-in-Time-Features, realisierte Opportunity-Surfaces (max-favorable / max-adverse Exkursionen ohne angewendeten Exit), Bracket-Outcome-Labels, Regime-Kontext und Methodik-Playbooks.

Designprinzip: Primitive, niemals eine Auswahl. Es gibt keinen „Was soll ich kaufen“-Endpunkt. Jeder Agent argumentiert aus denselben Daten zu seinem eigenen Vertrag und seinem eigenen Exit. Paper-Traded-Forschungsdaten; nur zu Bildungszwecken; keine Anlageberatung.

Gehosteter MCP-Endpunkt

• Streamable HTTP (primär): https://mcp.gammarips.com/mcp

• SSE (Legacy, Deprecation-Fenster): https://mcp.gammarips.com/sse

• Zustandsloses JSON-RPC: https://mcp.gammarips.com/jsonrpc

• Server-Card: https://mcp.gammarips.com/.well-known/mcp/server-card.json

• OAuth-Endpunkt (Chat-Clients): https://mcp.gammarips.com/pro. Derselbe Server, dieselben 9 Tools, aber er erfordert eine Anmeldedaten, sodass ChatGPT, Claude (claude.ai / Desktop), Cursor und jeder MCP-Client, der OAuth 2.1 spricht, beim Hinzufügen eine GammaRips-Anmeldung anbietet. Ihre Abo-Stufe steckt im Token. Discovery: /.well-known/oauth-protected-resource/pro; Autorisierungsserver: https://gammarips.com.

• Auth: zwei Anmeldedaten, eine Stufung. (1) API-Schlüssel: gr_live_... als Authorization: Bearer <key> (oder X-API-Key), für Clients, die einen Header senden können. (2) OAuth-2.1-Zugriffstoken, von gammarips.com nach Ihrer Anmeldung (Chat-Clients) oder von einem Maschinenclient mit client_credentials (Headless Agenten, siehe unten) ausgestellt. Free-Tier-Tools funktionieren auf /mcp ohne Anmeldedaten; die 4 Pro-Tools benötigen ein aktives Abo auf beiden Anmeldedaten. Enforce ist live. Zugang unter gammarips.com/pricing.

Related MCP server: TickerAPI

Verfügbare Tools (9)

V4 (2026-07-17) hat die 29-Tool-V3-Oberfläche auf 9 konsolidiert. Die absorbierten Tools leben als view= / granularity=-Modi dieser 9 weiter. web_search wurde entfernt.

Free-Tier (kein Schlüssel): get_pool, get_regime_context, get_market_calendar_status, get_playbook, get_daily_report. Pro-Tier (Agent Access, $39/Monat Schlüssel): get_signal, get_liquidity, query_outcomes, replay_contract.

• get_pool (frei) — der Kandidatenpool: view="enriched" (kuratierte Narrative/Technicals/Kontrakt/mom_60, leakage-sichere Ansicht; Standard), "raw" (Pre-Kurations-Scan), "features" (Point-in-Time-Feature-Vektoren aus der Allowlist-Ansicht), "preview" (öffentlicher Teaser).

• get_signal (pro) — ein Ticker: view="detail" (vollständige Anreicherung, Standard) oder view="earnings" (die Doktrin-Earnings-Fenster-Prüfung).

• get_liquidity (pro) — frische Entry-Day-Liquidität: ein einzelner contract (Cache-first, live=true zum Erzwingen von Upstream) oder der gesamte Pool / eine contracts-Shortlist in einem Aufruf. Keine Quote-Felder in diesem Datenplan.

• query_outcomes (pro) — das Outcomes- + Receipts-Substrat, über view=: labels (Zeilen-Level-Bracket-Labels + Features; Standard), summary (gruppierte Aggregate), surface (MFE/MAE-Exkursionen pro Kontrakt, exit-frei — aggregate_only=True gibt MFE/MAE-Quantile über das GESAMTE Fenster und ist der Modus für das Exit-Design, da der Zeilenmodus auf 200 Zeilen begrenzt ist und dies über truncated / matched_rows / partial_scan_date deklariert), harvest (Touch-Wahrscheinlichkeitskurve), exit_rule (bewerten Sie IHRE Bracket/Trailing Regel), signal_performance / win_rate (UNDERLYING-Richtung, nicht Option PnL), positions / performance (die realisierten Paper-Trade-Receipts der Engine, kohorten-gefiltert). Die Live-Kohorte ist das Paar V7_1_TILTED_GIGO und Entry am/nach cohort_start (2026-08-10), das Antworten jetzt tragen — das Policy-Label ALLEIN definiert die Kohorte nicht, da das Ledger verstoßene Kohorten unter demselben Label behält. Direkt nach einem Reset ist die Live-Kohorte legitimerweise leer: total_trades: 0 mit null-Aggregaten bedeutet „hat noch keine geschlossenen Trades angesammelt“, NICHT „0 % Win-Rate“. policy_version="all" erreicht jede Ära, enthält aber Kohorten, die die Engine verstoßen hat — keine Erfolgsbilanz.

• replay_contract (pro) — rohes Preistape für Ihre eigene Exit-Regel: granularity="minute" (Intraday-Pfad + exaktes erstes Crossing; Standard) oder "day" (tägliche OHLCV-Mark-Serie). Dieser Server simuliert keine Exits.

• get_regime_context (frei) — VIX/VIX3M/SPY-Trend zum Scan-Datum + die Fail-Closed-Regime-Schiene.

• get_market_calendar_status (frei) — view="status" (NYSE offen/geschlossen, Standard) oder view="scan_dates" (welche Scan-Daten Daten haben).

• get_playbook (frei) — Methodik + Referenz: keine Arg-Liste den Katalog; name= ruft ein Playbook ab (start-here, daily-workflow, run-your-own-tournament, exit-lab, leakage-and-data-contract, changelog) oder name="schema" den maschinenlesbaren Datenvertrag (pro Spalte Leakage-Klassifizierung); field= erklärt jedes Signalfeld (deterministisch, kein LLM). Playbooks sind auch MCP-Ressourcen (gammarips://playbooks/{name}).

• get_daily_report (frei) — view="report" (vollständiger Tagesbericht, Standard) oder view="list" (aktuelle Berichte).

Entfernt

web_search (V4). Die eigene tägliche Auswahl der Engine wird nicht am selben Tag veröffentlicht (get_todays_pick / list_todays_picks / get_open_position in V3 entfernt); realisierte Receipts bleiben über query_outcomes(view="positions") verfügbar.

Prompts

morning_brief, analyze_candidate(ticker), run_your_own_tournament — dünne Orchestrierungen über die obigen Tools. Keines gibt eine Auswahl zurück.

Schnellverbindung

Claude Code

# Free tier (no key):
claude mcp add --transport http gammarips https://mcp.gammarips.com/mcp

# Pro (with your key):
claude mcp add --transport http gammarips https://mcp.gammarips.com/mcp \
  --header "Authorization: Bearer gr_live_your_key"

# Pro with OAuth instead of a key (sign in once in the browser, tokens refresh):
claude mcp add --transport http gammarips https://mcp.gammarips.com/pro
# then run /mcp inside Claude Code and choose "Authenticate"

ChatGPT, Claude (claude.ai / Desktop) und andere OAuth-Chat-Clients

Fügen Sie einen benutzerdefinierten Connector / Remote-MCP-Server mit der URL https://mcp.gammarips.com/pro hinzu. Der Client entdeckt den Autorisierungsserver (gammarips.com), registriert sich selbst (Client-ID-Metadaten-Dokument oder dynamische Registrierung) und öffnet die GammaRips-Anmeldeseite + Zustimmungsseite. Kein Schlüssel zum Einfügen. Noch nicht abonniert? Die Verbindung funktioniert trotzdem mit den kostenlosen Tools, und die Pro-Tools antworten mit den Abo-Schritten; Pro-Zugriff wird beim nächsten Token-Refresh (innerhalb einer Stunde) nach dem Abo angewendet, oder wenn Sie sich erneut verbinden.

Headless-Agenten (eine VM, ein Cron, ein Server): Maschinen-Clients

Für einen Agenten ohne Browser und ohne Menschen erstellen Sie einen Maschinen-Client auf gammarips.com/account (Agent Access erforderlich). Sie erhalten eine client_id + client_secret (nur einmal angezeigt). Minten Sie ein Ein-Stunden-Zugriffstoken mit dem client_credentials-Grant und senden Sie es als Bearer:

TOKEN=$(curl -s -u "$GR_CLIENT_ID:$GR_CLIENT_SECRET" \
  -d grant_type=client_credentials \
  -d resource=https://mcp.gammarips.com/pro \
  https://gammarips.com/oauth/token | jq -r .access_token)

# Claude Code headless (claude -p), with the token in .mcp.json:
#   { "mcpServers": { "gammarips": { "type": "http",
#       "url": "https://mcp.gammarips.com/pro",
#       "headers": { "Authorization": "Bearer ${GAMMARIPS_MCP_TOKEN}" } } } }
GAMMARIPS_MCP_TOKEN="$TOKEN" claude -p "..." 

Minten Sie vor jedem Lauf: Es gibt kein Refresh-Token für Maschinen-Clients, und die Stufe wird bei jedem Mint erneut aus Ihrem Abo gelesen. Ein API-Schlüssel funktioniert für denselben Zweck; der Maschinen-Client ist die Option mit kurzlebigen Anmeldedaten.

Cursor

Am einfachsten — installieren Sie das Plugin. Dieses Repo ist ein Open Plugins-Standard-Plugin (.cursor-plugin/plugin.json): Es bündelt den gehosteten MCP-Server plus eine gammarips-options-flow-Fähigkeit, die Ihrem Agenten den Daten-nicht-Rat-Workflow beibringt. Installieren Sie es aus dem Plugin-Marktplatz (Suche „GammaRips“) oder zeigen Sie Cursor auf dieses Repo. Es verbindet sich sofort mit dem Free-Tier; fügen Sie Ihren gr_live_...-Schlüssel für Pro-Tools hinzu.

Manuell: Einstellungen → MCP → Neuen MCP-Server hinzufügen, oder zu .cursor/mcp.json hinzufügen:

{
  "mcpServers": {
    "gammarips": {
      "url": "https://mcp.gammarips.com/mcp",
      "headers": { "Authorization": "Bearer gr_live_your_key" }
    }
  }
}

Lassen Sie headers für den Free-Tier weg.

Cline

MCP-Server → Remote-Server → Hinzufügen, oder zu cline_mcp_settings.json hinzufügen:

{
  "mcpServers": {
    "gammarips": {
      "url": "https://mcp.gammarips.com/mcp",
      "type": "streamableHttp",
      "headers": { "Authorization": "Bearer gr_live_your_key" }
    }
  }
}

Lassen Sie headers für den Free-Tier weg (5 anon Tools).

Generische MCP-Konfiguration

{
  "mcpServers": {
    "gammarips": {
      "url": "https://mcp.gammarips.com/mcp"
    }
  }
}

Clients, die nur SSE sprechen, können während des Deprecation-Fensters den Legacy-/sse-Endpunkt verwenden.

Der Free-Tier funktioniert ohne Konto: get_pool, get_regime_context, get_market_calendar_status, get_playbook, get_daily_report. Pro-Tools (get_signal, get_liquidity, query_outcomes, replay_contract) erfordern Agent Access ($39/Monat) — generieren Sie einen Schlüssel unter gammarips.com oder verbinden Sie sich über /pro und melden Sie sich an.

Lokale Entwicklung

Voraussetzungen

• Python 3.10+

• Optional: Docker

Einrichtung

git clone https://github.com/DevDizzle/gammarips-mcp.git
cd gammarips-mcp
python -m venv .venv
source .venv/bin/activate
pip install -e .
cp .env.example .env

Lokal ausführen

PYTHONPATH=src python src/server.py

Der Server bindet an 0.0.0.0:${PORT:-8080}, Streamable HTTP unter /mcp (SSE-Fallback).

Docker

docker build -t gammarips-mcp .
docker run --rm -p 8080:8080 --env-file .env gammarips-mcp

Umgebung

Siehe .env.example für die aktuellen Umgebungsvariablen. Typische Werte umfassen:

• GCP_PROJECT_ID

• FIRESTORE_DATABASE

• GCS_BUCKET_NAME

• LOG_LEVEL

• PORT

• REQUIRE_API_KEY / AUTH_SHADOW (API-Key-Gate-Modus)

• OAUTH_ENABLED / OAUTH_ISSUER / OAUTH_JWKS_URL / OAUTH_MCP_RESOURCE_ORIGINS (OAuth-2.1-Ressourcenserver; Standardwerte sind Produktion, siehe src/utils/oauth.py)

Validierung

Python-Compile-Check

python -m compileall src

Docker-Build-Check

docker build -t gammarips-mcp:test .

Bereitstellung

Die Bereitstellung ist manuell (der CD-Workflow wurde entfernt; .github/workflows/ci.yml führt nur ruff format --check + ruff check bei Pushes/PRs auf main aus).

Versenden Sie eine neue Revision mit dem Deploy-Skript, das einen Cloud-Run-Quellcode-Deploy verwendet und die Live-Konfiguration exakt reproduziert (Geheimnisse über Secret Manager, REQUIRE_API_KEY=false):

bash scripts/deploy.sh

Äquivalenter Einzeiler:

gcloud run deploy gammarips-mcp --source=. \
  --project=profitscout-fida8 --region=us-central1 \
  --set-env-vars="REQUIRE_API_KEY=false" \
  --set-secrets="POLYGON_API_KEY=POLYGON_API_KEY:latest,GOOGLE_API_KEY=GOOGLE_API_KEY:latest,GOOGLE_CSE_ID=GOOGLE_CSE_ID:latest"

Die API-Schlüssel werden aus Secret Manager gemountet — übergeben Sie sie niemals als Klartext-Env-Vars (das überschreibt die Secret-Mounts).

Vor jedem Deploy, der die Datenexposition ändert: führen Sie das gammarips-review-Leakage-Audit aus (siehe docs/MCP-V3-SPEC.md §2.4).

Sicherheit

Siehe SECURITY.md für das Vertrauensmodell — Read-Only-Garantie, parametrisierte-Query-SQL-Injection-Abwehr, Antwortgrößen-Grenzen, Pro-IP-Rate Limits, bereinigte Fehler, Leakage-sichere Ansichten, den Spaltenklassifizierungs- Datenvertrag und das OAuth-2.1-Ressourcenserver-Modell (dieser Dienst verifiziert nur Token; gammarips.com ist der Autorisierungsserver).

Lizenz

MIT