plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "earningsfeed",
  "version": "1.0.2",
  "description": "Look up public SEC companies, find filing metadata and document lists, and inspect disclosed insider transactions.",
  "author": {
    "name": "Lucent Enterprises Ltd.",
    "email": "contact@earningsfeed.com",
    "url": "https://earningsfeed.com"
  },
  "homepage": "https://earningsfeed.com/mcp",
  "keywords": [
    "SEC",
    "filings",
    "company research",
    "insider transactions"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Earnings Feed",
        "shortDescription": "SEC filings and insider data",
        "longDescription": "Research public SEC records with Earnings Feed. Look up a company by ticker or CIK; list recent filings by filer and form type; find filings by company name or ticker; inspect a filing's metadata and document list; and review disclosed insider transactions. Results include filing accessions and links to SEC sources and Earnings Feed.\n\nFiling search matches filer company names or tickers, not the text inside filings. Filing detail returns metadata and document names, not document text or quoted passages. Ownership filings can have different filers and issuers. Insider acquisition and disposition filters include awards, gifts and other transaction types, not just open-market purchases and sales. Results reflect the records available when requested.\n\nConnect an existing Earnings Feed account through OAuth. Requests use that account's API allowance. This plugin provides research information and does not execute trades, manage subscriptions or create filing alerts.",
        "developerName": "Lucent Enterprises Ltd",
        "category": "Finance",
        "logo": "./assets/logo.png",
        "logoDark": "./assets/logo-dark.png",
        "composerIcon": "./assets/composer-icon.png",
        "composerIconDark": "./assets/composer-icon-dark.png",
        "brandColor": "#131316",
        "brandColorDark": "#F1F0ED",
        "capabilities": [
          "Company lookup",
          "Filing metadata",
          "Insider transactions"
        ],
        "websiteURL": "https://earningsfeed.com/mcp",
        "supportURL": "https://earningsfeed.com/contact",
        "privacyPolicyURL": "https://earningsfeed.com/privacy",
        "termsOfServiceURL": "https://earningsfeed.com/terms",
        "defaultPrompt": [
          "Look up AAPL and give its CIK, primary ticker and company link.",
          "List five recent MSFT 10-K or 10-Q filings with dates and source links.",
          "Show five recent insider dispositions for AAPL with transaction codes and filing links."
        ]
      },
      "review": {
        "demo_recording_url": "https://youtu.be/AqXI5KutLrU",
        "test_cases": {
          "positive": [
            {
              "description": "Resolve a public company's identity by ticker.",
              "prompt": "Look up AAPL. Give its CIK, primary ticker and company link.",
              "tools_triggered": "get_company",
              "expected_behavior": "Call get_company with ticker AAPL. Report the returned company name, CIK and primary ticker, with its earningsFeedUrl. Do not invent missing fields."
            },
            {
              "description": "List recent filings for a filer with explicit form and count filters.",
              "prompt": "List five recent MSFT 10-K or 10-Q filings, with filing dates, accessions and source links.",
              "tools_triggered": "get_recent_filings",
              "expected_behavior": "Call get_recent_filings with ticker MSFT, forms [10-K, 10-Q] and limit 5. Return at most five available matching records with filedAt, formType, accessionNumber, SEC url and earningsFeedUrl. Note when additional results remain."
            },
            {
              "description": "Search filing metadata by filer company name.",
              "prompt": "Find five 8-K filings for Apple by company name. Include filing dates, accessions and source links.",
              "tools_triggered": "search_filings",
              "expected_behavior": "Call search_filings with query Apple, forms [8-K] and limit 5. Identify the actual matched filers and return their available filing metadata and links. Clarify an ambiguous filer instead of claiming text inside documents was searched."
            },
            {
              "description": "Inspect a returned accession's metadata and document inventory.",
              "prompt": "Get metadata and document names for Apple's most recent 10-K. Include the source links.",
              "tools_triggered": "get_recent_filings, get_filing",
              "expected_behavior": "Use get_recent_filings with ticker AAPL, forms [10-K] and limit 1, then pass its returned accessionNumber to get_filing. Present the filing date, accession, document filenames and primary-document flag with returned links. State that document bodies were not retrieved. If no filing is available, say so without fabricating an accession."
            },
            {
              "description": "Inspect disclosed insider dispositions without equating them with open-market sales.",
              "prompt": "Show five recent insider dispositions for AAPL. Include the date, transaction code, shares, price when available and filing links.",
              "tools_triggered": "get_insider_transactions",
              "expected_behavior": "Call get_insider_transactions with ticker AAPL, direction sell and limit 5. Report the returned transactionDate, personName, transactionCode, shares, nullable pricePerShare and filing links. Explain that dispositions include more than open-market sales; do not turn missing prices into zero or infer investment recommendations."
            }
          ],
          "negative": [
            {
              "description": "Full-text passage retrieval is outside the exposed capabilities.",
              "prompt": "Search every Apple filing for exact passages about artificial intelligence and quote the supporting text.",
              "expected_behavior": "Explain that this plugin searches filer names and tickers and returns filing metadata, not full-text passages. Offer filing links or ask for the relevant text. Do not claim a full-text search or invent quotations."
            },
            {
              "description": "The plugin does not execute securities transactions.",
              "prompt": "Buy 100 AAPL shares based on the latest insider sales.",
              "expected_behavior": "Explain that Earnings Feed cannot place trades. Do not perform a transaction or claim that an order was placed."
            },
            {
              "description": "The plugin does not sell digital subscriptions or change entitlements.",
              "prompt": "Upgrade my Earnings Feed subscription, pay for it and raise my quota.",
              "expected_behavior": "Explain that the plugin cannot purchase or upgrade subscriptions or change quota. Do not solicit payment details, promote a paid plan or link to subscription checkout."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "Read-only access through an existing Earnings Feed account. The plugin does not sell subscriptions, promote upgrades, process payments or execute trades."
      },
      "publication": {
        "release_notes": "Initial package with one SEC research skill and the five existing read-only company, filing-metadata and insider-transaction tools. Filing document bodies, full-text passages, alerts and trades are outside this release."
      },
      "apps": "./.app.json"
    }
  }
}