DevDizzle/gammarips-mcp

Options-flow intelligence **primitives** for AI agents.
Every trading night GammaRips ranks 3,532 optionable US names by liquidity, takes the top 100, keeps the bullish ones, and prices one out-of-the-money call in each. That is a pool of roughly 40 to 50 contracts your agent can actually trade. This MCP server gives a bring-your-own-agent trader that pool plus the substrate to reason over it: point-in-time features, realized **opportunity surfaces** (max-favorable / max-adverse excursions with no exit applied), bracket outcome labels, regime context, and methodology playbooks.
**Better-quality contracts, by the numbers.** The pool is selected on contract liquidity. Since the liquidity rule went live (2026-08-24, 1,301 contracts), median open interest is 4,664 and median session volume is 1,039, against 906 and 232 in the 60 scan days before. The thinnest 10% still carry 1,635 open interest, against 29. In a 60-day study, no-fill at the 10:00 ET entry fell from 40.5% to 6.1%. Liquid contracts are the ones you can enter and exit near the quote.
**Design principle: primitives, never a pick.** There is no "what should I buy" endpoint. Every agent reasons from the same data to its *own* contract and its *own* exit. Paper-traded research data; educational only; not investment advice.
Hosted MCP endpoint
- **Streamable HTTP (primary):** https://mcp.gammarips.com/mcp
- **SSE (legacy, deprecation window):** https://mcp.gammarips.com/sse
- **Stateless JSON-RPC:** https://mcp.gammarips.com/jsonrpc
- **Server card:** https://mcp.gammarips.com/.well-known/mcp/server-card.json
- **OAuth endpoint (chat clients):** https://mcp.gammarips.com/pro. Same
server, same 9 tools, but it requires a credential, so ChatGPT, Claude
(claude.ai / Desktop), Cursor, and any MCP client that speaks OAuth 2.1
offers a GammaRips sign-in when you add it. Your subscription tier rides in
the token. Discovery: /.well-known/oauth-protected-resource/pro;
authorization server: https://gammarips.com.
- **Auth:** two credentials, one tiering. (1) API key: gr_live_... as
Authorization: Bearer (or X-API-Key), for clients that can send a
header. (2) OAuth 2.1 access token, minted by gammarips.com after you sign in
(chat clients) or by a machine client with client_credentials (headless
agents, see below). Free-tier tools work on /mcp with no credential at all;
the 4 pro tools need an active subscription on either credential. **Enforce**
is live. Get access at gammarips.com/pricing.
Available tools (9)
V4 (2026-07-17) consolidated the 29-tool V3 surface into 9. The absorbed tools
live on as view= / granularity= modes of these 9. web_search was removed.
**Free tier** (no key): get_pool, get_regime_context,
get_market_calendar_status, get_playbook, get_daily_report.
**Pro tier** (Agent Access, $29/mo key): get_signal, get_liquidity,
query_outcomes, replay_contract.
- get_pool **(free)** — the candidate pool: view="enriched" (curated
narrative/technicals/contract/mom_60, leakage-safe view; default),
"raw" (pre-curation scan), "features" (point-in-time feature vectors
from the allowlist view), "preview" (public teaser).
- get_signal **(pro)** — one ticker: view="detail" (full enrichment,
default) or view="earnings" (the doctrine earnings-window check).
- get_liquidity **(pro)** — fresh entry-day liquidity: a single contract
(cache-first, live=true to force upstream) or the whole pool / a
contracts shortlist in one call. No quote fields on this data plan.
- query_outcomes **(pro)** — the outcomes + receipts substrate, via view=:
labels (row-level bracket labels + features; default), summary (grouped
aggregates), surface (per-contract MFE/MAE excursions, exit-free —
aggregate_only=True gives MFE/MAE quantiles over the WHOLE window and is the