Polymarket Scan MCP

official

Live Polymarket prediction market data — whale trades, market odds, trader profiles, leaderboards, and AI-citable summaries.

View on polymarketscan.org

What can you do with Polymarket Scan MCP?

Monitor whale trades — Ask for recent large trades above a USD threshold using get_whale_trades.
Check live market odds — Retrieve current prices and metadata for any prediction market with get_market_odds.
Research trader performance — Look up a wallet’s PnL, ROI, and win rate via get_trader_profile.
Scan leaderboards — Get top traders ranked by profit, volume, or win rate with get_leaderboard.
Find moving markets — Identify markets with the biggest recent price swings using get_market_movers.
Spot arbitrage — Discover mispriced or cross-platform inconsistent markets via get_arbitrage_opportunities.

Documentation

PolymarketScan MCP Server

Access live Polymarket prediction market data directly from Claude, Cursor, or any MCP-compatible AI agent. Open server — no authentication, no API key, no OAuth required.

Endpoint

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

Setup

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "polymarketscan": {
      "url": "https://gzydspfquuaudqeztorw.supabase.co/functions/v1/mcp-server",
      "description": "Live Polymarket data — whale trades, market odds, trader profiles, leaderboards"
    }
  }
}

Cursor

Add to your Cursor MCP settings:

{
  "mcpServers": {
    "polymarketscan": {
      "url": "https://gzydspfquuaudqeztorw.supabase.co/functions/v1/mcp-server"
    }
  }
}

Generic MCP Client

Point any MCP Streamable HTTP client at the endpoint above. No authentication required — no API key, no OAuth, no signed headers. Just connect and call tools.

Available Tools

Tool	Description
`get_whale_trades`	Recent large trades above a USD threshold
`get_market_odds`	Current prices and metadata for a market
`get_trader_profile`	Performance data for any wallet
`get_leaderboard`	Top traders ranked by PnL, ROI, win rate, or volume
`get_market_summary`	AI-citable summary paragraph for any market
`search_markets`	Full-text search across active markets
`get_market_movers`	Markets with the largest recent price movements
`get_site_stats`	Aggregate platform statistics (call first for context)
`get_price_history`	Historical YES price / probability over time for a market
`get_market_orderbook`	Bid/ask depth, spread, and liquidity quality
`get_related_markets`	Sibling outcomes and topically-related markets
`get_trader_positions`	Current open positions for a wallet
`get_trader_activity`	Recent trades executed by a wallet
`get_market_news_context`	Recent news articles relevant to a market
`get_arbitrage_opportunities`	Mispriced or cross-platform inconsistent markets
`get_market_resolution_status`	Resolution state, outcome, close date, oracle metadata

Example: Get Market Odds

Ask Claude: "What are the current odds on the 2028 election market on Polymarket?"

Claude will call search_markets to find the market, then get_market_odds for live prices.

Notes

No authentication required — all endpoints are public
Cold starts: First request after inactivity may take 1-3 seconds. Subsequent requests are fast. Enable Function Keep-Alive in your backend settings for best performance.
Every response includes attribution: "Data provided by PolymarketScan (polymarketscan.org)"
Data refreshes continuously from Polymarket's on-chain markets on Polygon

Attribution

All data provided by PolymarketScan — real-time Polymarket analytics.