An open-source agent workflow harness for the GammaRips MCP curated options dataset.
GammaRips is a data layer, not a signal service. Every trading day, the engine filters ~3,500 optionable US stocks down to a curated cohort of liquid, tradable, high-edge option contracts and serves that dataset over MCP. Your agent pulls the surviving cohort, layers its own live catalyst research (X/Twitter cashtags, filings, web search, parallel subagents), and builds a deterministic trade plan with historical MFE/MAE excursion data.
Instead of dumping noisy raw chains into an LLM context window, GammaRips filters the US options universe down to the daily cohort of surviving contracts that pass strict quantitative and liquidity gates:
- Mid Price:
Mid >= $1.00 - Open Interest:
OI >= 500 - Delta Band:
Delta 0.22–0.48 - Days to Expiration:
DTE 10–45 - Volatility Edge:
RV/IV >= 0.85(realized volatility vs. implied volatility)
Connect any MCP-compatible agent (Claude Code, Grok, Codex, Cursor, or custom runners):
- Pro (OAuth):
https://mcp.gammarips.com/pro - API Key (Bearer):
https://mcp.gammarips.com/mcpwith headerAuthorization: Bearer gr_live_... - Free Preview (No Key):
https://mcp.gammarips.com/mcp(serves the daily report, regime context, market calendar, playbooks, and cohort preview)
Fetch today's surviving tradable option contracts and their point-in-time volatility and liquidity metrics (rv_iv_ratio, open_interest, mid_price, delta, dte, and opportunity surfaces), alongside market calendar status (get_market_calendar_status) and VIX term-structure regime ( get_regime_context).
GammaRips handles the quantitative options filtering; you bring the catalyst layer. Have your agent (Claude Code, Grok, Codex, Cursor) spin up parallel subagents or live X/Twitter and web search — for example, Grok searching live $TICKER cashtag chatter, SEC/FDA regulatory filings, or unpriced catalysts — to debate and rank the surviving contracts.
Size the position against your risk budget, set deterministic bracket exits (profit target, stop loss, and mandatory time-stop) using historical MFE/MAE excursion distributions (query_outcomes and replay_contract), pre-register the decision in eval/funnel-log.jsonl, and optionally route the order to your own broker MCP.
claude mcp add --transport http gammarips https://mcp.gammarips.com/mcp
Ask your agent for today's brief to inspect the market calendar, VIX regime context, daily report, and cohort preview.
- Subscribe atgammarips.com/pricing and create an API key atgammarips.com/account (or authenticate directly via OAuth at
https://mcp.gammarips.com/pro). - Export your key for
.mcp.json:
export GAMMARIPS_MCP_KEY="gr_live_..."
- Or install as a Claude Code plugin:
/plugin marketplace add DevDizzle/gammarips-harness
/plugin install gammarips@gammarips
- Run the daily skills:
/trade Step 1–3 morning workflow: pull cohort, layer catalysts, build exit plan
/review After the close: score every cohort contract with MFE/MAE outcomes
/coach On demand: referee trading behavior against your written rules
| Path | Description |
|---|---|
CLAUDE.md |
Agent instructions: dataset specification, 3-step workflow, and core rules |
.mcp.json |
Streamable HTTP MCP config ( https://mcp.gammarips.com/mcp withBearer ${GAMMARIPS_MCP_KEY} ) |
docs/TRADING-DOCTRINE.md |
Risk rules, hard exclusions, sizing framework, and deterministic exit discipline |
docs/OPERATIONS.md |
MCP endpoints ( /pro OAuth and/mcp Bearer key), session timing, and failure handling |
.claude/skills/ |
Agent procedures: trade ,review ,coach ,wiki-distill ,ste100 |
wiki/ |
Claim-tagged research notes ( findings/ ,literature/ ) and index registries |
eval/ |
Your local dataset: funnel-log.jsonl ,trades.jsonl ,behavior-ledger.jsonl |
scripts/ |
Validators ( funnel_log.py ,behavior_log.py ,lint.py ) and evaluators (edge.py ,skill_eval.py ) |
GammaRips is a financial data vendor. Everything in this repository is for educational and research purposes, configured for paper trading by default. Nothing here constitutes investment advice. Trade your own capital at your own risk.