devdizzle/gammarips

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "gammarips",
  "version": "1.0.0",
  "description": "Read-only options-flow data for AI agents: the nightly liquidity-ranked pool, point-in-time features, realized opportunity surfaces, and methodology. No pick endpoint. Educational research data, not investment advice.",
  "author": {
    "name": "GammaRips",
    "email": "evan@gammarips.com",
    "url": "https://gammarips.com"
  },
  "homepage": "https://gammarips.com/developers",
  "repository": "https://github.com/DevDizzle/gammarips-mcp",
  "license": "MIT",
  "keywords": [
    "options",
    "options-flow",
    "market-data",
    "trading-research",
    "finance",
    "mcp"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "GammaRips",
        "shortDescription": "Liquid options and exit data",
        "longDescription": "GammaRips gives you better-quality option contracts every US trading night, and the history to plan the exit. The engine ranks about 3,500 optionable US stocks by liquidity, keeps the 100 most liquid, keeps the bullish names, and selects one out-of-the-money call in each on contract liquidity. The pool holds roughly 40 to 50 contracts with deep books: median open interest 4,664 and median session volume 1,039, against 906 and 232 before the liquidity rule. In a 60-day study, no-fill at the 10:00 ET entry fell from 40.5% to 6.1%.\n\nThe plugin gives ChatGPT read-only tools over that data:\n- The daily pool with thesis, technicals, catalyst, and the selected contract for each name, plus a short preview\n- Signal detail and an earnings-window check for one ticker\n- Fresh liquidity for one contract\n- Realized outcomes: the opportunity surface (how far each past contract moved for and against), touch probabilities, bracket labels, and scoring for a target and stop you choose\n- Minute or daily price replay for one contract\n- Market regime (VIX vs VIX3M), the market calendar, and pool freshness\n- The daily report and methodology playbooks\n\nAsk for a trade and ChatGPT builds a plan with you from the data: candidates that pass the liquidity and earnings checks, a target and a stop set from what past pool contracts did, and a size that fits your maximum loss. There is no pick endpoint. The plan is ChatGPT's analysis with you, and you decide.\n\nSign in with your GammaRips account to connect.\n\nPaper-traded research data. Educational only. Not investment advice. GammaRips never places trades.",
        "developerName": "GammaRips",
        "category": "Finance",
        "capabilities": [
          "Read"
        ],
        "websiteURL": "https://gammarips.com",
        "supportURL": "https://gammarips.com/about#contact",
        "privacyPolicyURL": "https://gammarips.com/privacy",
        "termsOfServiceURL": "https://gammarips.com/terms",
        "defaultPrompt": [
          "What is in today's GammaRips options-flow pool?",
          "Does the GammaRips VIX regime rail pass right now?",
          "How far did last week's pool contracts move for and against?"
        ],
        "brandColor": "#1a1f2e",
        "brandColorDark": "#a4e600",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "demo_recording_url": "https://storage.googleapis.com/gammarips-public-media/plugin-review/gammarips-codex-demo.mp4",
        "commerce": false,
        "commerce_description": "GammaRips sells nothing inside ChatGPT. A user signs in with an existing GammaRips account through OAuth. When a tool is not in the user's plan, the plugin says so and links an informational plans page. It shows no prices or trial offers and starts no purchase.",
        "test_cases": {
          "positive": [
            {
              "description": "Reads the current nightly pool. The answer lists contracts as research data and does not choose one for the user.",
              "prompt": "What is in today's GammaRips options-flow pool? Show me the first 5 contracts.",
              "tools_triggered": "get_market_calendar_status, get_pool",
              "expected_behavior": "ChatGPT lists 5 pool rows with ticker, contract (strike and expiration), delta, and a one-line thesis, and gives the scan date. It labels the rows as research data, not a GammaRips recommendation."
            },
            {
              "description": "Reads the market regime rail.",
              "prompt": "Does the GammaRips VIX regime rail pass right now?",
              "tools_triggered": "get_regime_context",
              "expected_behavior": "ChatGPT gives the scan date, the VIX close, the VIX3M value, and whether the rail passes (it passes when VIX is at or below VIX3M). It notes that the regime lags the live pool by one to two trading days."
            },
            {
              "description": "Explains a data field from the field dictionary.",
              "prompt": "What does mom_60 mean in the GammaRips data, and is it safe to use for selection?",
              "tools_triggered": "get_playbook",
              "expected_behavior": "ChatGPT defines mom_60 as trailing 60-trading-day momentum of the underlying, as a fraction, guarded to dates at or before the scan date. It repeats the caveat that it is a research lever that depends on the exit horizon, not a rule."
            },
            {
              "description": "Reads the realized opportunity surface (Pro tool, the reviewer account has Pro).",
              "prompt": "Over the last 10 trading days, how far did GammaRips pool contracts move in their favor and against before they resolved?",
              "tools_triggered": "query_outcomes",
              "expected_behavior": "ChatGPT calls query_outcomes with view=\"surface\" and reports quantiles of the maximum favorable and maximum adverse excursion (MFE and MAE) with the row count and date range. It says no exit was applied and that these are historical research numbers, not an expected return."
            },
            {
              "description": "Summarizes the daily report.",
              "prompt": "Summarize the latest GammaRips daily report in five bullet points.",
              "tools_triggered": "get_daily_report",
              "expected_behavior": "ChatGPT gives the report title and scan date and five bullets that summarize it. It does not turn the report into a trade instruction."
            }
          ],
          "negative": [
            {
              "description": "Trade execution. GammaRips is read-only and has no tool that places, changes, or cancels an order. The plugin must not claim to place the trade.",
              "prompt": "Buy 10 AAPL call contracts for me at the market price right now."
            },
            {
              "description": "A guaranteed profit. GammaRips never promises a profit or an expected return, and it has no pick endpoint. The plugin must not promise a profit, state an expected return, or present a contract as a GammaRips recommendation. It can help the user build their own plan from the data, labeled as the user's analysis.",
              "prompt": "Which one option should I buy today to make the most money? Guarantee me a profit."
            },
            {
              "description": "Unrelated request. Nothing in GammaRips applies, so the plugin must not be called.",
              "prompt": "Give me a recipe for banana bread."
            }
          ]
        }
      },
      "publication": {
        "release_notes": "First release. Read-only GammaRips options-flow data through 9 MCP tools, plus one skill that keeps answers to research data, never advice or a pick."
      }
    }
  }
}