GammaRips

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

Better-quality contracts every night
The 100 most liquid optionable names, bullish only, and one out-of-the-money call per name, selected on contract liquidity. Your AI starts from contracts it can enter and exit near the quote.
4,705

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.

The exit lab
How often past pool contracts hit +20%, +50%, and +100%, within 3 trading days and before expiration, how far they moved for and against, and a score for any target and stop. Most contracts move both ways, so your AI sets the exit from history.
54.6%

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.

Your AI builds the trade plan
Ask for a trade. Your AI shortlists 1 to 3 candidates that pass the liquidity and earnings checks, then gives the entry, target, stop, maximum loss, and size. If nothing passes, it tells you why. You decide.
1 to 3

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

Free, no card, no key

One command. No card, no key, no signup.

  1. 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

Pro, $29/mo

All paid tools, and the harness loop. Add the same server with your key.

  1. 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. 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. 3

    Or clone the harness: its .mcp.json reads GAMMARIPS_MCP_KEY from your shell.

Claude app

Free, no card, no key

claude.ai and Claude Desktop.

  1. 1

    Open Customize, then Connectors, then Add custom connector.

  2. 2

    Paste https://mcp.gammarips.com/mcp and add it.

  3. 3

    Ask Claude for a morning brief. Free plans get one custom connector.

Claude app with Pro

Pro, $29/mo

No key to paste. Add the Pro URL as a custom connector and sign in.

  1. 1

    Open Customize, then Connectors, then Add custom connector.

  2. 2

    Paste the Pro URL and add it.

    https://mcp.gammarips.com/pro
  3. 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

Free, no card, no key

Plus, Pro, Business, Enterprise and Education plans, on the web.

  1. 1

    Settings, then Security and login, then turn Developer mode on.

  2. 2

    Open Plugins, press +, and enter a name and the URL https://mcp.gammarips.com/mcp. Set Authentication to No Authentication.

  3. 3

    Ask ChatGPT for a morning brief.

ChatGPT with Pro

Pro, $29/mo

No key to paste. Add the Pro URL and sign in.

  1. 1

    Settings, then Security and login, then turn Developer mode on.

  2. 2

    Open Plugins, press +, enter a name and the Pro URL, and set Authentication to OAuth.

    https://mcp.gammarips.com/pro
  3. 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

Free, no card, no key

One entry in .cursor/mcp.json (project) or ~/.cursor/mcp.json (global).

  1. 1

    Add the server. No headers means the free tier.

    {
      "mcpServers": {
        "gammarips": { "url": "https://mcp.gammarips.com/mcp" }
      }
    }

Cursor with Pro, using your key

Pro, $29/mo

All paid tools. Cursor sends headers and reads the key from your shell.

  1. 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

Pro, $29/mo

Skip the key. Point Cursor at the Pro URL with no headers.

  1. 1

    Add the Pro URL.

    {
      "mcpServers": {
        "gammarips": { "url": "https://mcp.gammarips.com/pro" }
      }
    }
  2. 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

Free, no card, no key

One block in ~/.codex/config.toml.

  1. 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

Pro, $29/mo

All paid tools. Codex reads the key from an environment variable.

  1. 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

Pro, $29/mo

Skip the key. Point Codex at the Pro URL, then log in once.

  1. 1

    Set the Pro URL in ~/.codex/config.toml.

    [mcp_servers.gammarips]
    url = "https://mcp.gammarips.com/pro"
  2. 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

Free, no card, no key

One command. No card, no key, no signup.

  1. 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

Pro, $29/mo

All paid tools. Add the same server with your key.

  1. 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

Endpoint:https://mcp.gammarips.com/mcp
Transport:Streamable HTTP (legacy SSE at /sse)
Auth:Authorization: Bearer <your API key>
Or sign in:https://mcp.gammarips.com/pro (OAuth 2.1, no key to paste)
Start with:get_playbook("start-here") · get_pool · query_outcomes

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@gammarips

The 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.

Pro endpoint:https://mcp.gammarips.com/pro
Auth server:https://gammarips.com
Discovery:/.well-known/oauth-protected-resource/pro (RFC 9728) and /.well-known/oauth-authorization-server (RFC 8414)
Grants:authorization_code, refresh_token, client_credentials
Registration:dynamic (RFC 7591) or a client ID metadata document
PKCE:S256, required
Scope:mcp:read

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.

morning_brief
Market status → regime check → today's pool → historical context by delta bucket → a briefing on the most interesting candidates, with data caveats.
analyze_candidate
Deep-dive one name: enrichment, excursion history, realized labels of similar setups, and the risks.
run_your_own_tournament
The engine's bracket-tournament selection pattern, run by YOUR AI against YOUR objective, horizon, and risk tolerance.

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.
get_pool
Free preview · Pro full
The candidate pool for a scan date, in one tool. view=preview is the free public view: ticker, direction, score, headline, flow dollars. The full pool comes with Pro: view=enriched (thesis, technicals, catalyst, the selected contract, the 60-day momentum feature), view=raw (the wide pre-curation scan), and view=features (point-in-time feature vectors from the leakage-safe view).
get_signal
Pro
Deep dive on one ticker. view=detail is the full enriched signal (thesis, catalyst, the selected contract, point-in-time features). view=earnings checks for an earnings date on or before the contract expiration. The pool can carry earnings-window names, so your AI runs this check on each candidate.
get_liquidity
Pro
Fresh entry-day liquidity, beyond the pool's session-frozen snapshot. Pass one contract for its live open interest, session volume, last trade, and greeks, or omit it to read the whole pool in one call for the 10:00 ET decision window. Bid and ask are not on the current data plan.

The exit lab and outcome history

The history your AI uses to set the target and the stop.
query_outcomes
Pro
The exit lab and the outcome history, in one tool with nine views. view=harvest gives how often past pool contracts touched each profit level and each stop. view=surface is the opportunity surface: realized peak and drawdown per contract with no exit applied. view=exit_rule scores your own target, stop, and horizon. view=labels and view=summary are row-level and grouped bracket outcomes. view=positions and view=performance hold the record of the engine's retired paper test.
replay_contract
Pro
The raw option price tape for your own entry and exit rule. granularity=minute returns the intraday minute path for one session and, if you pass a bracket, the exact first-crossing sequence. granularity=day returns the daily mark series. Your AI applies its own rule to real bars.

Free context, methodology, and reports

The reference layer that keeps your AI's answers grounded. No key needed.
get_regime_context
Free
Point-in-time volatility regime for a scan date: VIX versus VIX3M and the engine's regime rail evaluated on those values.
get_market_calendar_status
Free
view=status answers whether the US market is open today, from the deterministic NYSE calendar with holidays and early closes. view=scan_dates lists which recent scan dates have GammaRips data. view=freshness confirms that the pool your AI reads is the right pool for the session.
get_playbook
Free
Methodology and reference. Pass a name for a playbook in markdown: start-here, exit-lab, daily-workflow, and the bracket-tournament selection pattern your AI runs against your own objective. Pass field= for the plain-English definition of any signal field. Pass name=schema for the machine-readable data contract: every column with its leakage classification and as-of boundary.
get_daily_report
Free
view=report is the full daily intelligence report in markdown, the editorial synthesis of the scan. view=list returns the recent reports.

Pricing

FREE
The website and the free MCP tier
$0
  • ✓ 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
THE PRODUCT
Agent Access (MCP)
$29/mo
  • ✓ 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.

One email a week. Catch up in five minutes.

The GammaRips weekly briefing — engine state, the latest Lab experiment, and what the pool's outcome data showed. No firehose, no FOMO.

Free weekly newsletter. No spam. Unsubscribe anytime.

    We Use Cookies

    We use cookies to enhance your experience, analyze site traffic, and for marketing purposes. By clicking "Accept," you agree to our use of cookies. Read our Privacy Policy.