Open-source harness and MCP dataset for options trading with AI agents
GammaRips filters about 3,500 optionable US stocks each trading day into a liquid options cohort that MCP agents pull and plan using MFE/MAE bracket exits.
By Dillip Chowdary • Nov 17, 2026 • Source: github.com

At a glance
- Product
- gammarips-harness
- Role
- Data layer, not a signal service
- Universe
- ~3,500 optionable US stocks
- Gates
- Mid >= $1, OI >= 500, delta 0.22-0.48
- Window
- DTE 10-45, RV/IV >= 0.85
- Default
- Paper trading, not investment advice
In this post
The gammarips-harness repository is the 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. The agent pulls the surviving cohort, layers live catalyst research from X/Twitter cashtags, filings, web search, and parallel subagents, and builds a deterministic trade plan with historical MFE/MAE excursion data.
This report lays out the five quantitative gates, the three MCP endpoints, the morning workflow, the Claude Code quick start, and the repository files. It is for operators of Claude Code, Grok, Codex, Cursor, or a custom runner who want today's cohort, the market calendar, and the VIX regime inside an agent session. The operator still brings the catalyst research: X/Twitter cashtags, filings, web search, and parallel subagents.
01Five liquidity and volatility gates
Noisy raw chains stay out of the LLM context window. GammaRips keeps the daily cohort of surviving contracts that pass strict quantitative and liquidity gates, drawn from that universe of ~3,500 optionable US stocks. The mid price must be at least $1.00, and open interest must be at least 500.
Delta must sit between 0.22 and 0.48, and days to expiration must sit between 10 and 45. The volatility edge requires an RV/IV ratio of at least 0.85, which is realized volatility versus implied volatility. A contract has to pass all five checks to stay in the surviving cohort.
02Pro, API key, free preview
Claude Code, Grok, Codex, Cursor, and custom runners connect as MCP clients. The three modes are Pro with OAuth, an API key sent as a bearer token, and a free preview that needs no key. That preview serves the daily report, regime context, market calendar, playbooks, and a cohort preview.
| Access | Address | Served data |
|---|---|---|
| Pro (OAuth) | mcp.gammarips.com/pro | Authenticated Pro connection |
| API key (Bearer) | mcp.gammarips.com/mcp | Header Authorization: Bearer gr_live_... |
| Free preview (no key) | mcp.gammarips.com/mcp | Daily report, regime context, market calendar, playbooks, cohort preview |
The bearer route and the no-key preview share one URL, mcp.gammarips.com/mcp, while Pro OAuth uses mcp.gammarips.com/pro. API-key calls send the header Authorization: Bearer and a key prefixed gr_live_. The no-key call on /mcp is the free preview, and the OAuth call on /pro is the Pro connection.
03Cohort pull, catalysts, trade plan
Advertisement
Tech Pulse Daily
Get tomorrow's pulse first
Join engineers who read Tech Pulse before stand-up. Free, weekday mornings.
GammaRips handles the quantitative options filtering, and the operator brings the catalyst layer. Claude Code, Grok, Codex, or Cursor can spin up parallel subagents or live X/Twitter and web search, including $TICKER cashtag chatter, SEC or FDA regulatory filings, and unpriced catalysts. The agent uses that research to debate and rank the contracts that survived the gates.
- Pull the daily cohort The agent calls get_pool for 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, plus get_market_calendar_status and get_regime_context for the VIX term-structure regime.
- Layer catalyst search The agent runs parallel subagents or live X/Twitter and web search, for example Grok on $TICKER cashtag chatter, SEC or FDA filings, or unpriced catalysts, then debates and ranks the surviving contracts.
- Build the trade plan The operator sizes the position against the risk budget and sets deterministic bracket exits (profit target, stop loss, and a mandatory time-stop) from historical MFE/MAE distributions via query_outcomes and replay_contract, pre-registers the decision in eval/funnel-log.jsonl, and can route the order to the operator's own broker MCP.
Those exits are a profit target, a stop loss, and a mandatory time-stop, read from historical MFE/MAE excursion distributions. query_outcomes and replay_contract are the two history calls. The decision is pre-registered in eval/funnel-log.jsonl, and routing the order to a broker MCP is optional.
04Preview command and daily skills
The free preview needs no key and is a 10-second try. Claude Code adds it with claude mcp add --transport http gammarips https://mcp.gammarips.com/mcp. The operator then asks the agent for today's brief, which inspects the market calendar, VIX regime context, daily report, and cohort preview.
- Subscribe and create a key Subscribe at gammarips.com/pricing, create an API key at gammarips.com/account, or authenticate with OAuth at mcp.gammarips.com/pro.
- Export the bearer key Run export GAMMARIPS_MCP_KEY="gr_live_..." so .mcp.json sends Bearer ${GAMMARIPS_MCP_KEY} to mcp.gammarips.com/mcp.
- Install the Claude Code plugin Run /plugin marketplace add DevDizzle/gammarips-harness and then /plugin install gammarips@gammarips.
- Run /trade The morning skill pulls the cohort, layers catalysts, and builds the exit plan.
- Run /review After the close, the skill scores every cohort contract with MFE/MAE outcomes.
- Run /coach On demand, the skill referees trading behavior against the operator's written rules.
.mcp.json is the streamable HTTP MCP config and carries the GAMMARIPS_MCP_KEY bearer value to mcp.gammarips.com/mcp. /trade is the step 1-3 morning workflow. /review scores the full cohort on MFE/MAE after the close, and /coach checks behavior against those written rules when the operator asks.
05Doctrine files and local logs
CLAUDE.md holds the agent instructions: the dataset specification, the 3-step workflow, and the core rules. .mcp.json points at mcp.gammarips.com/mcp with Bearer ${GAMMARIPS_MCP_KEY}. docs/TRADING-DOCTRINE.md stores the risk rules, hard exclusions, sizing framework, and deterministic exit discipline, and docs/OPERATIONS.md covers the /pro OAuth and /mcp bearer endpoints, session timing, and failure handling.
.claude/skills/ contains the procedures trade, review, coach, wiki-distill, and ste100. wiki/ keeps claim-tagged research notes under findings/ and literature/, plus index registries. eval/ is the local dataset (funnel-log.jsonl, trades.jsonl, behavior-ledger.jsonl), and scripts/ supplies validators funnel_log.py, behavior_log.py, and lint.py plus evaluators edge.py and skill_eval.py.
Note: GammaRips is a financial data vendor, and everything in this repository is for educational and research purposes, configured for paper trading by default. Nothing here constitutes investment advice. Operators trade their own capital at their own risk.
Frequently asked questions
What is gammarips-harness?
gammarips-harness is an open-source agent workflow harness for the GammaRips MCP curated options dataset. GammaRips is a data layer, not a signal service. Each trading day it filters ~3,500 optionable US stocks into a cohort and serves that cohort over MCP.
Which option contracts survive the daily gates?
The mid price must be at least $1.00, open interest at least 500, delta between 0.22 and 0.48, and days to expiration between 10 and 45. RV/IV, realized volatility versus implied volatility, must be at least 0.85.
How does an MCP agent connect to GammaRips?
Pro uses OAuth at mcp.gammarips.com/pro. An API key calls mcp.gammarips.com/mcp with header Authorization: Bearer gr_live_.... The free preview uses mcp.gammarips.com/mcp with no key and returns the daily report, regime context, market calendar, playbooks, and a cohort preview.
What do /trade, /review, and /coach do?
/trade runs the morning workflow: pull the cohort, layer catalysts, and build the exit plan. /review runs after the close and scores every cohort contract with MFE/MAE outcomes. /coach runs on demand and referees trading behavior against the operator's written rules.
Is GammaRips investment advice?
No. GammaRips is a financial data vendor. The repository is for educational and research purposes, paper trading is the default, and nothing in it constitutes investment advice.
Sources
Author
Dillip Chowdary
Writes Tech Bytes coverage of AI, engineering, and the tools that actually ship. Editor of Tech Pulse Daily.
Related on Tech Bytes
Advertisement