The options-flow data layer for AI agents
9 MCP tools over the GammaRips engine: the curated overnight pool, opportunity surfaces, a queryable outcome database, and the methodology itself. Your agent reasons to its own conclusions. There is no pick endpoint, on purpose.
Try it right now. No card, no key.
claude mcp add --transport http gammarips https://mcp.gammarips.com/mcpThe anonymous tier serves the pool preview, daily reports, methodology playbooks, and reference tools with zero setup. Ask your agent for a morning brief and see what comes back.
The full data layer (outcome history, opportunity surfaces, exit-rule simulation, all 9 tools) is $29/mo with a 30-day free trial. That is the founding price for the first 100 subscribers; it is $39/mo after the cap. After you subscribe, generate your API key at /account. It is shown once, so copy it then.
Two ways to reach the paid tools. Claude Code, Codex, Cursor, Gemini CLI and any client that can send an Authorization header use your API key on https://mcp.gammarips.com/mcp. A chat client that cannot send a header adds https://mcp.gammarips.com/pro instead and signs in with OAuth. The anonymous tier works everywhere, with neither.
Quick Start
claude mcp add --transport http gammarips \ https://mcp.gammarips.com/mcp \ --header "Authorization: Bearer YOUR_API_KEY"
# export GAMMARIPS_MCP_KEY=YOUR_API_KEY [mcp_servers.gammarips] url = "https://mcp.gammarips.com/mcp" bearer_token_env_var = "GAMMARIPS_MCP_KEY"
{
"mcpServers": {
"gammarips": {
"url": "https://mcp.gammarips.com/mcp",
"headers": { "Authorization": "Bearer ${env:GAMMARIPS_MCP_KEY}" }
}
}
}gemini mcp add --transport http -s user \ -H "Authorization: Bearer YOUR_API_KEY" \ gammarips https://mcp.gammarips.com/mcp
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)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 your own exit, pre-register every decision as data, and score the whole pool after the close. Paper-only by default. It ships no pick, because there is none to ship. Clone it and change the parts you disagree with.
Sign in instead of pasting a key
Some chat clients cannot send an Authorization header, so they could never reach the paid tools. They can now. https://mcp.gammarips.com/pro serves the same transport and the same 9 tools, 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 still works on https://mcp.gammarips.com/pro, and https://mcp.gammarips.com/mcpstays anonymous, 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 agent can run over the tools. None of them returns a pick; each ends in a decision surface you reason about.
9 Tools
Every tool is leakage-checked: nothing your agent reads contains information that wasn't knowable at the time it's dated. The outcome database behind these tools holds 4,900+ labeled contracts across 90+ scan days: every pool candidate since April 2026, growing 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. Roughly 40 to 50 contracts, structured for machine reasoning.Research substrate
The deep data a human never browses. This is what you're paying for.Free context, methodology, and reports
The reference layer that kills whole classes of hallucination. No key needed.Pricing
- ✓ Today's curated pool, human-readable
- ✓ Daily reports + per-ticker deep dives
- ✓ Public scorecard + the Lab
- ✓ Methodology + full disclosures
- ✓ Free forever, not a trial
- ✓ All 9 tools + the built-in prompts
- ✓ Opportunity surfaces + outcome database
- ✓ Exit-rule simulation + regime context
- ✓ Methodology playbooks
- ✓ 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, exposing 9 tools. Any MCP client can call it, and so can an ordinary HTTP client. An anonymous tier is open with no key and no card. The pro tools take a bearer API key on either endpoint, or an OAuth 2.1 sign-in at https://mcp.gammarips.com/pro for clients that cannot send a header.
What options flow data does the API return?
The curated overnight pool (ticker, direction, overnight score, flow dollars, thesis, technicals, catalyst, and one call contract per name, chosen on contract liquidity), point-in-time feature vectors from a leakage-safe view, opportunity surfaces giving realized excursion distributions for historical setups, a queryable outcome database, exit-rule simulation, 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 picks one out-of-the-money call in each. The pool is roughly 40 to 50 contracts and publishes each trading morning. Liquidity decides membership, not unusual activity. Flow is context, not a filter. This is a data layer for analysis, not a real-time tape for execution.
How do I connect Claude or ChatGPT to options flow data?
In Claude Code, run: claude mcp add --transport http gammarips https://mcp.gammarips.com/mcp. That reaches the anonymous tier immediately. Every other MCP client can add the same URL: claude.ai, ChatGPT (Developer mode) and Grok as a custom connector, Codex, Cursor and Gemini CLI in their MCP config. For the full data layer there are two ways in. If your client can send headers, keep the same URL and add Authorization: Bearer plus your API key. That is Claude Code, Codex, Cursor and Gemini CLI. If your client cannot send a header, add https://mcp.gammarips.com/pro instead and it will walk you through an OAuth sign-in, which is how a chat client reaches the paid tools without a key. Full steps per client are in the connect section on the homepage.
Does the API return trade recommendations?
No, and there is no pick endpoint, deliberately. The API serves data and tools that your own agent reasons over to reach its own conclusion. All data is on a paper-trading basis, educational only, and is not investment advice.
What does the options flow API cost?
The anonymous tier is free: pool preview, daily reports, methodology playbooks, and reference tools. Full access to all 9 tools is $29/mo with a 30-day free trial. The entire human web interface is free and always will be.
Give your agent something real to reason over
A chatbot with no data improvises. An agent with the pool, the surfaces, and the methodology does analysis. Connect yours in minutes.