Polymarket Scan MCP

PolymarketScan MCP Server

Read-only data from Polymarket.com prediction markets for AI assistants. Connect ChatGPT, Claude, Grok, Cursor, Claude Code or any MCP client to get market-implied probabilities (odds), price history, the biggest moves, trending markets, large trades, buy and sell flow, public trader stats and related news.

• No account, API key or OAuth. Every tool is public and read-only.
• Read-only. The tools cannot place, change or cancel orders, move funds or access any account.
• Version: 2.0.0 (October 2026). Protocol: MCP over Streamable HTTP (stateless, JSON responses).

Endpoint

https://mcp.polymarketscan.org/mcp

The original address keeps working and serves the same server:

https://gzydspfquuaudqeztorw.supabase.co/functions/v1/mcp-server/mcp

Tools (11)

Your MCP client reads each tool's full input and output schema from the server (tools/list). Every input except those marked required is optional.

search_markets (Search prediction markets)

Searches open Polymarket.com markets and returns the closest matches, each with up to six outcomes' market-implied probabilities, 24-hour change and volume.

• Inputs: query (required): the event, person, team, asset or question in plain words, up to 200 characters. limit: 1 to 10, default 5.
• Notes: open markets only. Outcomes the query names come first, then the leaders (or a price ladder's rungs nearest 50%). For one market's full outcome list, rules and status, use get_market_odds.
• Try asking: "What are the odds for the Fed's next rate decision?"

get_market_odds (Get market odds)

One market or event in full: each outcome's probability and 24-hour change (up to 40 outcomes, plus the total count), volume, liquidity, end date, status, resolution rules and source, and the result once resolved.

• Inputs: market (required): a market or event slug, a polymarket.com or polymarketscan.org link, a condition ID (0x + 64 hex), or the market in plain words.
• Notes: works for open, closed and resolved markets. Mutually exclusive outcomes are ranked by probability. If nothing matches, it returns up to 3 of the closest open markets instead.
• Try asking: "Show me every candidate's chances in the 2028 presidential election."

get_price_history (Get price history)

How one outcome's probability changed over a time range: start and end, change in percentage points, high and low, and a chart.

• Inputs: market (required): as for get_market_odds. outcome: the outcome to chart, such as "Yes" or a candidate's name; default is the leading open outcome of a multi-outcome event, or the first outcome of a single market. range: 1d, 1w, 1m, 3m or all, default 1w.
• Notes: prices come from Polymarket.com's order-book history. Gaps in quiet markets are left unfilled. For a closed or resolved market the range ends when trading closed.
• Try asking: "How have the odds of a US recession changed this month?"

get_market_movers (Get biggest market moves)

Open markets with the biggest 24-hour changes in probability (in percentage points), with the outcome that moved, its current probability and 24-hour volume; at most two per event.

• Inputs: direction: up, down or both, default both. category: one of politics, elections, geopolitics, world, economy, finance, crypto, tech, culture, sports, esports, weather or science; omit for all categories. limit: 1 to 20, default 10.
• Notes: covers the 300 most-traded markets (per category when one is given) with at least $10K traded in 24 hours. Markets priced at 1% or below or 99% or above are left out as effectively decided. Individual sports and esports games (single matches and their point-margin and total-points lines, upcoming or in progress) are left out unless the category is sports or esports; futures such as a season or championship winner stay in.
• Try asking: "Which prediction markets moved the most today?"

get_trending_markets (Get trending markets)

The open events with the most trading volume in the last 24 hours, each with up to four outcomes' probabilities (the leaders, or a price ladder's rungs nearest 50%), 24-hour change and volume.

• Inputs: category: the same values as get_market_movers; omit for all categories. limit: 1 to 20, default 8.
• Notes: events that already look settled (an outcome at 99% or more) and games' secondary prop sheets are left out. Individual sports and esports games (single matches, upcoming or in progress) are left out unless the category is sports or esports; futures such as a season or championship winner stay in.
• Try asking: "What's trending on Polymarket in crypto?"

get_whale_trades (Get large trades)

The largest recent trades from Polymarket.com's public trade feed, biggest first, with time, side, outcome, dollar size, shares, price, market and the trader's wallet and public name.

• Inputs: min_usd: smallest trade in US dollars, 1,000 to 1,000,000, default 10,000. market: limit to one market or event (a slug, a polymarket.com or polymarketscan.org link, a condition ID, or a few words); omit for all markets. hours: how far back to look, 1 to 168, default 24. limit: 1 to 50, default 15.
• Notes: across all markets, fills at 99¢ or more or 1¢ or less (effectively decided markets) are left out. Each fill is counted once; dollars are shares times price. If the feed is too busy to scan the whole window, the result says how much it covers.
• Try asking: "Show me Polymarket trades over $50K in the last 24 hours."

get_market_flow (Get market flow)

Who is buying and selling one market: dollars bought, sold and net per outcome, the trade count, up to 8 largest trades and up to 5 top holders per outcome.

• Inputs: market (required): as for get_market_odds. hours: how far back to look, 1 to 168, default 24.
• Notes: for a multi-outcome event it uses the leading open outcome (for a price ladder, the most-traded open rung) and says so. Dollar totals count each fill once (its taker side), so they run about half of the two-sided volume Polymarket.com headlines. In very busy markets small fills may be left out so the whole window fits; the result says so.
• Try asking: "Who is buying the Bitcoin $150K market?"

get_leaderboard (Get trader leaderboard)

Polymarket.com's trader leaderboard by profit or volume: rank, full wallet address, public display name, profit and dollar volume, with a profile link.

• Inputs: metric: profit or volume, default profit. period: day (since 00:00 UTC), week (7 days), month (30 days) or all, default month. category: one of sports, politics, crypto, economics, finance, tech, culture, esports, weather or mentions; omit for all markets. limit: 1 to 25, default 10.
• Notes: day, week and month profit includes open positions at current prices; all-time profit is realized only. Polymarket does not publish per-category dollar volume, so category boards leave it empty.
• Try asking: "Who are the top Polymarket traders by profit this month?"

get_trader_profile (Get trader profile)

One trader's public stats: display name, all-time realized profit and volume, portfolio value, open positions, markets traded, and up to 5 largest positions and 8 latest trades.

• Inputs: trader (required): a full 0x wallet address (42 characters), a polymarket.com profile link, an @username or a username.
• Notes: a username is matched exactly when possible; otherwise the closest public profile is used and the result says so. Recent trades are those of $1 or more. It does not say who controls a wallet.
• Try asking: "Look up this Polymarket trader: 0x…"

get_trader_positions (Get trader positions)

Up to 50 of a trader's open positions with shares, average and current price, value and unrealized profit or loss, plus the total count and portfolio value.

• Inputs: trader (required): as for get_trader_profile. sort: value (largest current value first) or pnl (largest unrealized gain first), default value. limit: 1 to 50, default 20.
• Notes: positions worth under $1 and resolved positions awaiting redemption are left out of the list.
• Try asking: "What are this trader's biggest open positions?"

get_market_news (Get market news)

Up to 10 headlines from the last 14 days about a market or topic, with outlet, publish time and link, from PolymarketScan's news feed of major outlets.

• Inputs: market: a market or event slug, a polymarket.com or polymarketscan.org link, or a condition ID; plain words are treated as the topic. query: topic words such as "bitcoin etf"; with a market, keeps only that market's news that mentions them. limit: 1 to 10, default 5. Give a market, a query or both.
• Notes: not a full web search: it returns no article text and may find nothing for niche markets.
• Try asking: "Is there news behind the move in the Fed decision market?"

Results

• Units are the same in every tool: probabilities are 0 to 1, price changes are in percentage points, prices are in cents, money is in US dollars and share counts are labelled as shares. A null value means the figure isn't available, never zero. Wallets are full lowercase addresses, so results can be passed straight into the trader tools.
• Footers. Each result's text ends with "Source: Polymarket.com via PolymarketScan. Informational only, not financial advice." Results about trades or positions (get_whale_trades, get_market_flow, get_leaderboard, get_trader_profile, get_trader_positions) add "Trading is risky; 100% loss can occur." get_market_news ends with "Source: news outlets via PolymarketScan's news feed. Informational only, not financial advice." instead.
• Links. Market and trader links open PolymarketScan analytics pages and carry ?ref=mcp, which marks the visit as coming from an AI assistant. No result links to a trading page on polymarket.com. News headlines link to the publisher's article.
• Errors. If Polymarket's data service doesn't respond, a tool returns a short plain-English message asking you to try again. It never passes on a raw upstream or database error.

The card

In hosts that support MCP Apps (such as ChatGPT), results render in an interactive PolymarketScan card: odds, price charts, ranked lists of markets, trades and traders. The card loads nothing from the network itself. In other clients the same results arrive as structured data plus a short plain-English summary.

Add it to your assistant

ChatGPT

• Plugin directory: once PolymarketScan is listed, open the plugin directory in ChatGPT, search for "PolymarketScan" and connect it.
• Developer mode (before the listing, or to test): turn on Settings → Security and login → Developer mode, go to chatgpt.com/plugins, click +, enter https://mcp.polymarketscan.org/mcp and choose no authentication.

Claude (claude.ai and Claude Desktop)

• Connectors directory: once PolymarketScan is listed, add it from Settings → Connectors → Browse connectors.
• Custom connector: Settings → Connectors → Add custom connector. Name it PolymarketScan, use the URL https://mcp.polymarketscan.org/mcp and leave the OAuth fields empty.

Grok

Add a custom connector (MCP server) with the URL https://mcp.polymarketscan.org/mcp and no authentication.

Claude Code

claude mcp add --transport http polymarketscan https://mcp.polymarketscan.org/mcp

Cursor

Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):

{
  "mcpServers": {
    "polymarketscan": {
      "url": "https://mcp.polymarketscan.org/mcp"
    }
  }
}

Clients that only run local (stdio) servers

Bridge with mcp-remote, for example in claude_desktop_config.json:

{
  "mcpServers": {
    "polymarketscan": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.polymarketscan.org/mcp"]
    }
  }
}

Any MCP client or plain HTTP

Point a Streamable HTTP client at the endpoint. The server is stateless and answers JSON-RPC over POST /mcp with JSON:

curl -s https://mcp.polymarketscan.org/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Data source

Odds, prices, trades, holders, leaderboards and trader statistics are fetched from Polymarket.com's public APIs when a tool is called. News headlines come from PolymarketScan's own news feed of major outlets. Polymarket.com responses are cached for at most a minute; leaderboards, settled markets and public profile names are cached for 2 minutes to an hour.

Privacy

The server receives only the tool calls an assistant makes, never your conversation. It logs two kinds of request: a client connecting (initialize) and a tool being used (tools/call). Listing the tools and other protocol messages are not logged. Each record holds the action (a connection, or the tool's name), the client type worked out from the user agent, the first 300 characters of the user agent, a keyed hash of the connecting IP address (HMAC-SHA-256 with a server secret, shortened) and the time. Tool inputs and results are not stored. Details: Privacy Policy, section 3.

Disclaimer

Source: Polymarket.com via PolymarketScan. Informational only, not financial advice. Market-implied probabilities are crowd forecasts, not certainties. Data may be delayed or wrong; check important figures on the linked page. Trading is risky; 100% loss can occur.

PolymarketScan is an independent analytics platform, not Polymarket. Terms of Service · Privacy Policy · Contact · support@polymarketscan.org