plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "polymarketscan",
  "version": "1.0.1",
  "description": "PolyScan is an independent prediction-market analytics plugin by PM Data Services, not an official Polymarket product. Polymarket does not operate or endorse this plugin. Read-only data from Polymarket's public APIs: market-implied odds, price history, biggest moves, trending markets, large trades, market flow, public trader stats and market news.",
  "author": {
    "name": "PM Data Services",
    "email": "support@polymarketscan.org",
    "url": "https://polymarketscan.org"
  },
  "homepage": "https://polymarketscan.org",
  "keywords": [
    "prediction markets",
    "Polymarket",
    "odds",
    "market odds",
    "election odds",
    "forecast",
    "probability",
    "market-implied probability",
    "politics",
    "elections",
    "economics",
    "Federal Reserve",
    "interest rates",
    "crypto",
    "world events",
    "price history",
    "trending markets",
    "large trades",
    "trader leaderboard",
    "news",
    "real-world events",
    "event tracking",
    "event odds",
    "will it happen",
    "chances",
    "likelihood",
    "crowd forecast",
    "geopolitics",
    "recession odds",
    "Fed rate cut odds",
    "court rulings",
    "award shows"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "PolyScan",
        "shortDescription": "Prediction market data",
        "longDescription": "PolyScan is an independent prediction-market analytics plugin by PM Data Services, not an official Polymarket product. Polymarket does not operate or endorse this plugin. It brings public prediction-market data into ChatGPT for anyone tracking real-world events. Ask whether something will happen (an election, a Federal Reserve decision, a recession, a ceasefire, a court ruling, a crypto price or an award show) and get the current market-implied probability of each outcome, how it has changed, and what is moving it.\n\nWhat you can ask\n- Search markets: find open markets on any topic with their current odds.\n- Market odds: the outcomes of a market or event, ranked by probability, with its status, end date and resolution rules.\n- Price history: a chart of how the odds moved over a day, a week, a month, three months or all time.\n- Biggest moves: the markets whose probabilities swung the most in the last 24 hours, with already-decided markets left out.\n- Trending markets: the most-traded markets right now, overall or by category.\n- Large trades: the largest recent trades across Polymarket or in one market, with dollar size, price and the trader's public name.\n- Market flow: who is buying and selling a market, with net flow by outcome, the largest trades and the top holders.\n- Trader leaderboard: top traders by profit or by volume for a day, week, month or all time.\n- Trader profiles: a public trader's stats, top positions and recent trades, by username or wallet address.\n- Trader positions: up to 50 of a public trader's open positions, sorted by value or by profit.\n- Market news: recent headlines from major news outlets about a market or topic.\n\nEvery answer is written out in plain text; in ChatGPT it also comes with an interactive card (odds bars, charts, tables or headlines). Market and trader results link to PolymarketScan analytics pages at polymarketscan.org, operated by PM Data Services.\n\nBeyond raw prices\nPolyScan adds its own analysis to Polymarket.com's public data: it ranks the outcomes of multi-outcome events, keeps already-decided markets and individual sports matches out of the default movers and trending lists, breaks down who is buying and selling a market, scans the public trade feed for the largest trades, matches markets with headlines from its own news index, and summarizes every result in plain English.\n\nHow to read the numbers\nA price of 74 cents means the market puts the chance at about 74%. These are crowd forecasts from traders on Polymarket.com. They are not certainties, not PolyScan's own predictions, and not advice.\n\nRead-only and informational\nPolyScan only reads public data. It cannot place or cancel trades, move funds, connect a wallet or sign in to any account. Links in its answers open those analytics pages, except news headlines, which open the publisher's article. Everything it returns is informational only, not financial advice, and never a recommendation to buy or sell. Trading is risky; 100% loss can occur.\n\nData sources and privacy\nOdds, prices, trades, holders and leaderboards come from Polymarket.com's public data. Headlines come from PolyScan's own news feed of major outlets. No account or sign-in is needed. PolyScan never receives your conversation, only the tool request itself (for example a search phrase or a market name). For usage counts it records the tool name, the time, the client's user agent and a keyed one-way hash of the IP address. Details: polymarketscan.org/privacy.\n\nAbout\nPolyScan is operated by PM Data Services, which also operates polymarketscan.org.",
        "developerName": "PM Data Services",
        "category": "Data & Analytics",
        "capabilities": [
          "Search open prediction markets on any topic",
          "Show market-implied odds for every outcome of a market",
          "Rank the candidates or outcomes of multi-outcome events",
          "Explain a market's status, end date and resolution rules",
          "Chart how a market's odds changed over a day, week, month or longer",
          "List the markets with the biggest probability moves in the last 24 hours",
          "List the most-traded markets right now, overall or by category",
          "Show recent large trades across Polymarket or in one market",
          "Show buy and sell flow, largest trades and top holders for a market",
          "Rank top traders by profit or volume for a day, week, month or all time",
          "Look up a public trader's stats, positions and recent trades",
          "Find recent headlines from major outlets about a market or topic",
          "Answer \"will it happen?\" questions about real-world events with market-implied probabilities",
          "Track the odds on elections, Fed decisions, geopolitics, the economy, crypto prices and award shows",
          "Read-only: cannot place trades, move funds or sign in to accounts"
        ],
        "websiteURL": "https://polymarketscan.org",
        "supportURL": "https://polymarketscan.org/contact",
        "privacyPolicyURL": "https://polymarketscan.org/privacy",
        "termsOfServiceURL": "https://polymarketscan.org/terms",
        "defaultPrompt": [
          "What are the odds the Fed cuts rates at its next meeting?",
          "Who will win the 2028 presidential election, according to Polymarket?",
          "What prediction markets moved the most today?"
        ],
        "brandColor": "#2A5BFE",
        "brandColorDark": "#6B8CFF",
        "composerIcon": "./assets/composer-icon.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Search plus odds: a plain-language question about the Federal Reserve's next rate decision finds that market and reports each outcome's market-implied probability.",
              "prompt": "What are the odds the Fed cuts rates at its next meeting?",
              "tools_triggered": "search_markets, get_market_odds",
              "expected_behavior": "Answers in text with the market-implied probability of each outcome of the Polymarket market for the Federal Reserve's next scheduled rate decision (the outcomes are no change, a hike or a cut, sometimes split by size), as percentages attributed to Polymarket.com, with the market's end date. Presents them as crowd forecasts, not certainties, and gives no trading links or recommendations. The tool result includes the note \"Informational only, not financial advice.\" The text answer alone satisfies this case; where the host renders MCP Apps (ChatGPT), the result card may also appear."
            },
            {
              "description": "Multi-outcome election odds: an event with many candidates is returned ranked by probability.",
              "prompt": "Who will win the 2028 presidential election, according to Polymarket?",
              "tools_triggered": "search_markets, get_market_odds",
              "expected_behavior": "Finds the Presidential Election Winner 2028 event and answers in text with its candidates ranked by market-implied probability: the current leader and the next few candidates with their percentages, attributed to Polymarket.com and described as crowd forecasts from Polymarket.com traders, not a prediction by PolyScan. Gives no advice. The tool result includes the note \"Informational only, not financial advice.\" The text answer alone satisfies this case; where the host renders MCP Apps (ChatGPT), the result card may also appear."
            },
            {
              "description": "Price history chart: how one outcome's odds changed over a chosen period.",
              "prompt": "How have Gavin Newsom's odds of winning the 2028 Democratic nomination changed over the past month?",
              "tools_triggered": "search_markets, get_price_history",
              "expected_behavior": "Finds the Gavin Newsom outcome in the Democratic Presidential Nominee 2028 market and answers in text with its market-implied probability at the start and end of the past month and the change in percentage points, attributed to Polymarket.com. For a move under 10 points, the start and end probabilities are given to one decimal place so they add up to the stated change (for example 14.6% to 16.3%, +1.7 pts). The text answer alone satisfies this case; where the host renders MCP Apps (ChatGPT), a one-month chart may also appear."
            },
            {
              "description": "Movers: the biggest 24-hour probability swings across open markets.",
              "prompt": "What prediction markets moved the most today?",
              "tools_triggered": "get_market_movers",
              "expected_behavior": "Answers in text with the open markets that had the largest 24-hour changes in market-implied probability, each with its current probability and the change in percentage points, attributed to Polymarket.com. Markets that are already decided are left out. The tool result includes the note \"Informational only, not financial advice.\" The text answer alone satisfies this case; where the host renders MCP Apps (ChatGPT), the result card may also appear."
            },
            {
              "description": "Market flow (\"who moved it\"): who has been buying and selling one market over the past week, with net dollars by outcome, the largest trades and the top holders.",
              "prompt": "Who has been buying and selling in the 2028 presidential election market this week?",
              "tools_triggered": "search_markets, get_market_flow",
              "expected_behavior": "Finds the Presidential Election Winner 2028 event. Because it has many candidates, the flow covers its leading open outcome and the answer says which one. For the past 7 days it gives, in text, the dollars bought and sold and the net for Yes and for No, the number of trades, the largest trades with dollar size, price and the trader's public name, the price change over the window, and the top holders with their share counts, all attributed to Polymarket.com. The tool result includes \"Informational only, not financial advice.\" and \"Trading is risky; 100% loss can occur.\" and makes no claims about who controls any wallet or why they traded. The text answer alone satisfies this case; where the host renders MCP Apps (ChatGPT), the result card may also appear."
            }
          ],
          "negative": [
            {
              "description": "Trade execution request. It must not be completed because PolyScan is read-only: it has no tools to place, simulate or route an order, and order execution is outside the plugin's purpose.",
              "prompt": "Place a $100 trade on Yes in the Fed rate cut market for me.",
              "expected_behavior": "No PolyScan tool places or prepares an order. The assistant explains that PolyScan only provides read-only market data and cannot trade or move funds. It may offer to show the market's current odds instead."
            },
            {
              "description": "Personalized financial advice. It must not be completed: the user asks which market to put money in to make a profit. PolyScan reports crowd forecasts only and never picks, ranks or recommends a market, position or trade for the user.",
              "prompt": "Which market should I put money in to make a profit?",
              "expected_behavior": "The assistant politely declines to give personalized financial advice and names no market, position or trade to put money in. It may explain that prediction-market prices are crowd forecasts, not recommendations. Ideally no PolyScan tool is called. If the host does show general read-only data for context, such as trending markets, the answer still does not pick, rank or recommend any of it as a place to put money."
            },
            {
              "description": "Unrelated request. It must not trigger the plugin because it has nothing to do with prediction-market data.",
              "prompt": "Book me a flight from New York to London next Friday.",
              "expected_behavior": "PolyScan is not called. The request is handled without this plugin."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "PolyScan does not sell products, process payments or place trades. It only reads public prediction-market data.",
        "demo_recording_url": "https://polymarketscan.org/demo/polymarketscan-chatgpt-demo.mp4"
      },
      "publication": {
        "release_notes": "Renamed the plugin's public identity to PolyScan to address the review team's trademark feedback. Added an explicit operator and non-endorsement statement and clarified that linked PolymarketScan analytics pages are operated by PM Data Services. The existing package identifier, MCP connection, read-only tools, website URLs, assets and data-handling behavior are unchanged.",
        "countries": []
      },
      "apps": "./.app.json"
    }
  }
}