The options-flow data layer for AI agents
Give your AI better contractsand the history to plan the exit.
9 MCP tools for Claude, ChatGPT, Cursor, and Codex. Every night your AI gets a pool of liquid option contracts, the exit lab, and the checks to build a trade plan with you: entry, target, stop, and size. You decide.
Free tier: no card, no key, no signup. Pro: $29/mo founding price, 30-day free trial.
What your AI gets
median open interest, vs 906 before the liquidity rule
N=1,725 pool contracts Aug 24 to Oct 15, 2026, vs N=3,501 over the 60 scan days before the rule.
of pool contracts hit +50% before expiration
N=793 expired pool contracts, scan dates Aug 24 to Oct 1, 2026. +20%: 73.0%. +100%: 37.1%. Updated daily.
candidates per plan, each with entry, target, stop, and size
Built by your AI from GammaRips data, for your account and your risk budget.
Past results: real-money trades and historical pool data. Educational only. Not investment advice.
Connect your AI
Try the free tier first: no card, no key, no signup. With Pro, sign in at https://mcp.gammarips.com/pro or send your API key, and all 9 tools open. Then ask your AI for a trade plan.
Claude
The GammaRips plugin for Claude is being submitted to the Claude directory. These steps connect the same server today, in Claude Code and in the Claude app.
Claude Code
One command. No card, no key, no signup.
- 1
Add the server, then ask Claude for a morning brief.
claude mcp add --transport http gammarips https://mcp.gammarips.com/mcp
Claude Code with Pro
All paid tools, and the harness loop. Add the same server with your key.
- 1
Mint your key on the account page after the trial starts. Paste it with no spaces and no newline.
claude mcp add --transport http gammarips https://mcp.gammarips.com/mcp \ --header "Authorization: Bearer YOUR_API_KEY" - 2
Or skip the key and sign in. Add the /pro endpoint, then run /mcp inside Claude Code and authenticate.
claude mcp add --transport http gammarips https://mcp.gammarips.com/pro - 3
Or clone the harness: its .mcp.json reads GAMMARIPS_MCP_KEY from your shell.
Claude app
claude.ai and Claude Desktop.
- 1
Open Customize, then Connectors, then Add custom connector.
- 2
Paste https://mcp.gammarips.com/mcp and add it.
- 3
Ask Claude for a morning brief. Free plans get one custom connector.
Claude app with Pro
No key to paste. Add the Pro URL as a custom connector and sign in.
- 1
Open Customize, then Connectors, then Add custom connector.
- 2
Paste the Pro URL and add it.
https://mcp.gammarips.com/pro - 3
Claude opens the GammaRips sign-in. Approve access on gammarips.com with the account that carries your subscription. All 9 tools appear, and the token refreshes itself from then on.
ChatGPT
The GammaRips plugin is being submitted to the ChatGPT and Codex plugin directory. These steps connect the same server today.
ChatGPT
Plus, Pro, Business, Enterprise and Education plans, on the web.
- 1
Settings, then Security and login, then turn Developer mode on.
- 2
Open Plugins, press +, and enter a name and the URL https://mcp.gammarips.com/mcp. Set Authentication to No Authentication.
- 3
Ask ChatGPT for a morning brief.
ChatGPT with Pro
No key to paste. Add the Pro URL and sign in.
- 1
Settings, then Security and login, then turn Developer mode on.
- 2
Open Plugins, press +, enter a name and the Pro URL, and set Authentication to OAuth.
https://mcp.gammarips.com/pro - 3
ChatGPT opens the GammaRips sign-in. Approve access on gammarips.com with the account that carries your subscription. All 9 tools appear, and the token refreshes itself from then on.
Cursor
The GammaRips plugin is coming to cursor.directory. These steps connect the same server today.
Cursor
One entry in .cursor/mcp.json (project) or ~/.cursor/mcp.json (global).
- 1
Add the server. No headers means the free tier.
{ "mcpServers": { "gammarips": { "url": "https://mcp.gammarips.com/mcp" } } }
Cursor with Pro, using your key
All paid tools. Cursor sends headers and reads the key from your shell.
- 1
Export GAMMARIPS_MCP_KEY, then add the header.
{ "mcpServers": { "gammarips": { "url": "https://mcp.gammarips.com/mcp", "headers": { "Authorization": "Bearer ${env:GAMMARIPS_MCP_KEY}" } } } }
Cursor with Pro, signing in
Skip the key. Point Cursor at the Pro URL with no headers.
- 1
Add the Pro URL.
{ "mcpServers": { "gammarips": { "url": "https://mcp.gammarips.com/pro" } } } - 2
Cursor runs the OAuth sign-in for the server. Approve access on gammarips.com with the account that carries your subscription. All 9 tools appear, and the token refreshes itself from then on.
Codex
The GammaRips plugin is being submitted to the ChatGPT and Codex plugin directory. These steps connect the same server today.
Codex
One block in ~/.codex/config.toml.
- 1
Add the server. Codex connects with no credential when none is set.
[mcp_servers.gammarips] url = "https://mcp.gammarips.com/mcp"
Codex with Pro, using your key
All paid tools. Codex reads the key from an environment variable.
- 1
Export GAMMARIPS_MCP_KEY in your shell, then point Codex at it.
[mcp_servers.gammarips] url = "https://mcp.gammarips.com/mcp" bearer_token_env_var = "GAMMARIPS_MCP_KEY"
Codex with Pro, signing in
Skip the key. Point Codex at the Pro URL, then log in once.
- 1
Set the Pro URL in ~/.codex/config.toml.
[mcp_servers.gammarips] url = "https://mcp.gammarips.com/pro" - 2
Run the login. Approve access on gammarips.com with the account that carries your subscription. All 9 tools appear, and the token refreshes itself from then on.
codex mcp login gammarips
Any other MCP client
Gemini CLI, Grok, and every other MCP client reach the same 9 tools. Add https://mcp.gammarips.com/mcp for the free tier. For Pro, send your API key as an Authorization header, or add https://mcp.gammarips.com/pro in a client that supports OAuth and sign in.
Gemini CLI
One command. No card, no key, no signup.
- 1
Add the server, then ask Gemini for a morning brief. Add -s user to make it global.
gemini mcp add --transport http gammarips https://mcp.gammarips.com/mcp
Gemini CLI with Pro
All paid tools. Add the same server with your key.
- 1
Mint your key on the account page after the trial starts. Paste it with no spaces and no newline.
gemini mcp add --transport http -H "Authorization: Bearer YOUR_API_KEY" \ gammarips https://mcp.gammarips.com/mcp
Python (fastmcp)
from fastmcp import Client
from fastmcp.client.transports import StreamableHttpTransport
transport = StreamableHttpTransport(
"https://mcp.gammarips.com/mcp",
headers={"Authorization": "Bearer YOUR_API_KEY"},
)
async with Client(transport) as client:
pool = await client.call_tool("get_pool", {})
print(pool)Reference
Start from a working loop
The harness is open source. It is a daily agent loop over these tools: grade tradeability, form a thesis, design the exit, record every decision as data, and score the whole pool after the close. Paper-only by default. Install it as a Claude Code plugin, or clone it and make it yours.
/plugin marketplace add DevDizzle/gammarips-harness
/plugin install gammarips@gammaripsThe plugin bundles the free endpoint and the loop skills. For the pro tools, export GAMMARIPS_MCP_KEY and start Claude Code again. Run the skills inside a clone of the repo, which holds the data directory and the scripts.
Sign in instead of pasting a key
Chat clients sign in. https://mcp.gammarips.com/pro serves the same transport and the same 9 tools as https://mcp.gammarips.com/mcp, and it answers an anonymous request with a challenge that names our authorization server. Your client follows it, you approve the consent screen with the account that carries your subscription, and the tools appear. The token refreshes itself and re-reads your subscription every time.
Nothing to register by hand: your client registers itself. Refresh tokens rotate, and replaying a spent one revokes the whole family. An API key also works on https://mcp.gammarips.com/pro, and https://mcp.gammarips.com/mcp stays open, so the free tier never needs an account.
Headless agents
A cron job or a server-side agent has no browser to send you to. Create a machine client on your account page and use the client_credentials grant: your agent exchanges its client ID and secret for an access token and calls https://mcp.gammarips.com/pro directly. Revoke it there too, and the next mint fails.
Built-in prompts
The server ships MCP prompts: ready-made workflows your AI can run over the tools. Each one ends in analysis that you decide on.
9 tools
Every tool is leakage-checked: nothing your AI reads contains information that was not knowable at the time it is dated. The outcome history covers every pool candidate since April 2026 and grows every trading day. Full parameter schemas are self-describing over MCP.
The pool
The 100 most liquid optionable names, bullish only, one out-of-the-money call each, selected on contract liquidity. Roughly 40 to 50 contracts, structured for your AI.The exit lab and outcome history
The history your AI uses to set the target and the stop.Free context, methodology, and reports
The reference layer that keeps your AI's answers grounded. No key needed.Pricing
- ✓ The nightly pool, on the site
- ✓ Daily reports and per-ticker deep dives
- ✓ The scorecard and the Lab
- ✓ Free MCP tools: pool preview, reports, regime, calendar, playbooks
- ✓ Free forever, not a trial
- ✓ All 9 tools and the built-in prompts
- ✓ The full pool: thesis, technicals, catalyst, contract
- ✓ The exit lab: hit rates, surfaces, exit-rule scoring
- ✓ Fresh liquidity and earnings checks
- ✓ Sign in with OAuth, or use an API key
- ✓ 30-day free trial · cancel anytime
Founding price: $29/mo for the first 100 subscribers, locked as long as you stay subscribed. $39/mo after that.
Options flow API: common questions
Is there a GammaRips options flow API?
Yes. The GammaRips options flow API is an MCP server at https://mcp.gammarips.com/mcp, served over Streamable HTTP, with 9 tools. Claude, ChatGPT, Cursor, Codex, and any other MCP client can call it, and so can an ordinary HTTP client. The free tier needs no key and no card. The pro tools take an OAuth 2.1 sign-in at https://mcp.gammarips.com/pro, or a bearer API key on either endpoint.
What options flow data does the API return?
The nightly pool: roughly 40 to 50 bullish names, each with its overnight score, flow dollars, thesis, technicals, catalyst, and one out-of-the-money call selected on contract liquidity. Also point-in-time feature vectors from a leakage-safe view, fresh liquidity for any pool contract, the exit lab (opportunity surfaces, how often past contracts touched each profit level, and a score for any target and stop), minute and daily price replay, regime context, the daily reports, and the methodology playbooks.
Is the options flow data real time or overnight?
Overnight. The scan runs after the close across about 3,500 optionable US stocks. It keeps the 100 most liquid names, takes the bullish ones, and selects one out-of-the-money call in each on contract liquidity. The pool holds roughly 40 to 50 contracts and publishes each trading morning. Liquidity decides membership, and flow gives context. For the entry window, get_liquidity reads fresh open interest and session volume on any pool contract.
How do I connect Claude, ChatGPT, Cursor, or Codex?
Each client has its own steps on this page. In Claude Code, run: claude mcp add --transport http gammarips https://mcp.gammarips.com/mcp for the free tier. In the Claude app and ChatGPT, add https://mcp.gammarips.com/mcp as a custom connector to try it free, or add https://mcp.gammarips.com/pro and sign in with your GammaRips account for Pro. Cursor and Codex take one config entry, with your API key or a sign-in. GammaRips plugins are being submitted to the Claude directory, the ChatGPT and Codex plugin directory, and cursor.directory.
Why doesn't the API just tell me what to buy?
Because your AI can build a plan for your account and your risk: 1 to 3 candidates that pass the liquidity and earnings checks, each with an entry, a target and a stop set from history, and a size. One shared list crowds everyone into the same contracts. A plan built from the data, for your account, does not. You decide on every trade. All data is educational only and not investment advice.
What does the options flow API cost?
The free tier costs nothing: the pool preview, daily reports, regime context, the market calendar, and the methodology playbooks. Pro opens all 9 tools for $29/mo, the founding price for the first 100 subscribers, with a 30-day free trial. The whole website is free.
Give your AI something real to plan with
With the pool, the exit lab, and the liquidity and earnings checks, your AI turns a question into a trade plan you can act on. Connect it in a minute.