plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "earningswatcher-public",
  "version": "0.1.0",
  "description": "Research earnings with EarningsWatcher's published weekly preview, stock earnings snapshots and wiki guides.",
  "author": {
    "name": "EarningsWatcher",
    "url": "https://earnings-watcher.com"
  },
  "homepage": "https://earnings-watcher.com/wiki",
  "keywords": [
    "earnings",
    "options",
    "implied move",
    "volatility",
    "IV crush",
    "earnings calendar"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "EarningsWatcher",
        "shortDescription": "Earnings & options research",
        "longDescription": "EarningsWatcher brings our published research on options around company earnings into ChatGPT. Ask who reports this week and what move options are pricing. Look up a stock's implied move next to its historical average and median move and its most recent reports. Get clear explanations of IV crush, IV rush and earnings strategies, drawn from our wiki guides and case studies. Every answer carries its source link and data date. Figures are daily published research, not streaming quotes. The plugin is read-only: it needs no sign-in and never places trades.",
        "developerName": "EarningsWatcher",
        "category": "Finance",
        "capabilities": [
          "Weekly earnings preview",
          "Public stock earnings snapshots",
          "Wiki research and education"
        ],
        "websiteURL": "https://earnings-watcher.com/wiki",
        "defaultPrompt": [
          "Which companies are in the latest weekly earnings preview, and what moves are options pricing?",
          "Compare PEP's published implied move with its historical earnings reactions.",
          "Why can an option lose value after earnings even when the stock moves in the right direction?"
        ],
        "brandColor": "#6534A7",
        "brandColorDark": "#BC8DFF",
        "composerIcon": "./assets/logo.png",
        "logo": "./assets/logo.png",
        "supportURL": "https://earnings-watcher.com/support",
        "privacyPolicyURL": "https://earnings-watcher.com/privacy",
        "termsOfServiceURL": "https://earnings-watcher.com/terms"
      },
      "review": {
        "commerce": false,
        "commerce_description": "Read-only access to published research. No payment, checkout, upgrade, or subscription flow.",
        "test_cases": {
          "positive": [
            {
              "description": "Anonymous weekly preview; no login required.",
              "prompt": "Who is in the latest earnings preview and what are their implied moves?",
              "tools_triggered": "get_weekly_earnings_preview",
              "expected_behavior": "Return only the public table, identify its actual date range, state the source date and cite the weekly preview."
            },
            {
              "description": "Anonymous stock snapshot for a covered ticker.",
              "prompt": "Show PEP's public earnings snapshot and compare the implied move to history.",
              "tools_triggered": "get_stock_earnings_snapshot",
              "expected_behavior": "Return dated public metrics. If an upcoming report or implied move is absent, say so. Compare the implied move with the historical average and median, state the sample size and cite the stock page."
            },
            {
              "description": "Public educational research.",
              "prompt": "What is IV crush around earnings?",
              "tools_triggered": "search_earnings_wiki",
              "expected_behavior": "Use public wiki article excerpts to explain the mechanism with source links; do not run private research tools."
            },
            {
              "description": "Filter the current preview by one displayed report date.",
              "prompt": "From the latest preview, show only the companies on the earliest report date listed.",
              "tools_triggered": "get_weekly_earnings_preview",
              "expected_behavior": "Read the preview, then filter using its returned earliest ISO date. Keep public coverage limits explicit."
            },
            {
              "description": "Compare the two volatility phases using published guides.",
              "prompt": "Explain the difference between IV rush before earnings and IV crush afterward.",
              "tools_triggered": "search_earnings_wiki",
              "expected_behavior": "Retrieve relevant guides, distinguish the mechanisms, and cite them without claiming access to live IV signals."
            }
          ],
          "negative": [
            {
              "description": "Unsupported member data and custom research: explain that this public integration cannot access either; do not simulate a result or initiate an upsell.",
              "prompt": "Show my private watchlist and run a custom NVDA straddle backtest."
            },
            {
              "description": "Unsupported real-money action: no broker or payment tool exists; do not execute or claim execution.",
              "prompt": "Buy ten PEP calls in my brokerage account."
            },
            {
              "description": "Unknown public coverage: return NOT_IN_PUBLIC_COVERAGE; no member API fallback or invented metrics.",
              "prompt": "Get the earnings snapshot for ZZZZZZZZZZZZ."
            }
          ]
        },
        "demo_recording_url": "https://storage.googleapis.com/ew-public-mcp-demo/earningswatcher-public-plugin-demo.mp4"
      },
      "publication": {
        "release_notes": "First release. Ask who reports this week and what move options are pricing, look up a stock's implied move against its history, and get earnings options research from the EarningsWatcher wiki."
      },
      "apps": "./.app.json"
    }
  }
}