{"slug": "open-source-harness-and-mcp-dataset-for-options-trading-with-ai-agents", "title": "Open-source harness and MCP dataset for options trading with AI agents", "summary": "GammaRips released an open-source agent workflow harness and MCP dataset that filters roughly 3,500 optionable US stocks each trading day down to a curated cohort of liquid option contracts, served over the Model Context Protocol at mcp.gammarips.com. The dataset applies fixed gates — mid price of at least $1.00, open interest of at least 500, delta of 0.22–0.48, 10–45 days to expiration, and a realized-to-implied volatility ratio of at least 0.85 — and connects to MCP-compatible agents including Claude Code, Grok, Codex and Cursor via OAuth, a Bearer API key, or a no-key free preview. The harness ships Claude Code skills (/trade, /review, /coach) and a local eval log at eval/funnel-log.jsonl, positioning GammaRips as a data layer rather than a signal service that leaves catalyst research and trade sizing to the user's agent.", "body_md": "An open-source agent workflow harness for the **GammaRips MCP** curated options dataset.\n\nGammaRips 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.\n\nInstead 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:\n\n- **Mid Price:**`Mid >= $1.00`\n- **Open Interest:**`OI >= 500`\n- **Delta Band:**`Delta 0.22–0.48`\n- **Days to Expiration:**`DTE 10–45`\n- **Volatility Edge:**`RV/IV >= 0.85` (realized volatility vs. implied volatility)\n\nConnect any MCP-compatible agent (Claude Code, Grok, Codex, Cursor, or custom runners):\n\n- **Pro (OAuth):**`https://mcp.gammarips.com/pro`\n- **API Key (Bearer):**`https://mcp.gammarips.com/mcp` with header`Authorization: Bearer gr_live_...`\n- **Free Preview (No Key):**`https://mcp.gammarips.com/mcp` (serves the daily report, regime context, market calendar, playbooks, and cohort preview)\n\nFetch 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`).\n\nGammaRips 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.\n\nSize 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.\n\n```\nclaude mcp add --transport http gammarips https://mcp.gammarips.com/mcp\n```\n\nAsk your agent for today's brief to inspect the market calendar, VIX regime context, daily report, and cohort preview.\n\n1. **Subscribe** at[gammarips.com/pricing](https://gammarips.com/pricing) and create an API key at[gammarips.com/account](https://gammarips.com/account) (or authenticate directly via OAuth at`https://mcp.gammarips.com/pro` ).\n2. **Export your key** for`.mcp.json` :\n\n```\nexport GAMMARIPS_MCP_KEY=\"gr_live_...\"\n```\n\n3. **Or install as a Claude Code plugin:**\n\n```\n/plugin marketplace add DevDizzle/gammarips-harness\n/plugin install gammarips@gammarips\n```\n\n4. **Run the daily skills:**\n\n```\n/trade    Step 1–3 morning workflow: pull cohort, layer catalysts, build exit plan\n/review   After the close: score every cohort contract with MFE/MAE outcomes\n/coach    On demand: referee trading behavior against your written rules\n```\n\n| Path | Description | \n|---|---|\n| `CLAUDE.md` | Agent instructions: dataset specification, 3-step workflow, and core rules | \n| `.mcp.json` | Streamable HTTP MCP config ( `https://mcp.gammarips.com/mcp` with`Bearer ${GAMMARIPS_MCP_KEY}` ) | \n| `docs/TRADING-DOCTRINE.md` | Risk rules, hard exclusions, sizing framework, and deterministic exit discipline | \n| `docs/OPERATIONS.md` | MCP endpoints ( `/pro` OAuth and`/mcp` Bearer key), session timing, and failure handling | \n| `.claude/skills/` | Agent procedures: `trade` ,`review` ,`coach` ,`wiki-distill` ,`ste100` | \n| `wiki/` | Claim-tagged research notes ( `findings/` ,`literature/` ) and index registries | \n| `eval/` | Your local dataset: `funnel-log.jsonl` ,`trades.jsonl` ,`behavior-ledger.jsonl` | \n| `scripts/` | Validators ( `funnel_log.py` ,`behavior_log.py` ,`lint.py` ) and evaluators (`edge.py` ,`skill_eval.py` ) | \n\nGammaRips 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.", "url": "https://wpnews.pro/news/open-source-harness-and-mcp-dataset-for-options-trading-with-ai-agents", "canonical_source": "https://github.com/DevDizzle/gammarips-harness", "published_at": "2026-11-16 20:08:03+00:00", "updated_at": "2026-11-16 20:23:43.400668+00:00", "lang": "en", "topics": ["ai-agents", "agent-protocols", "ai-tools", "developer-tools"], "entities": ["GammaRips", "Model Context Protocol", "Claude Code", "Grok", "Codex", "Cursor"], "also_reported_by": [], "alternates": {"html": "https://wpnews.pro/news/open-source-harness-and-mcp-dataset-for-options-trading-with-ai-agents", "markdown": "https://wpnews.pro/news/open-source-harness-and-mcp-dataset-for-options-trading-with-ai-agents.md", "text": "https://wpnews.pro/news/open-source-harness-and-mcp-dataset-for-options-trading-with-ai-agents.txt", "jsonld": "https://wpnews.pro/news/open-source-harness-and-mcp-dataset-for-options-trading-with-ai-agents.jsonld"}}