Polymarket Scan MCP Server

official

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

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

ToolDescription
get_whale_tradesRecent large trades above a USD threshold
get_market_oddsCurrent prices and metadata for a market
get_trader_profilePerformance data for any wallet
get_leaderboardTop traders ranked by PnL, ROI, win rate, or volume
get_market_summaryAI-citable summary paragraph for any market
search_marketsFull-text search across active markets
get_market_moversMarkets with the largest recent price movements
get_site_statsAggregate platform statistics (call first for context)
get_price_historyHistorical YES price / probability over time for a market
get_market_orderbookBid/ask depth, spread, and liquidity quality
get_related_marketsSibling outcomes and topically-related markets
get_trader_positionsCurrent open positions for a wallet
get_trader_activityRecent trades executed by a wallet
get_market_news_contextRecent news articles relevant to a market
get_arbitrage_opportunitiesMispriced or cross-platform inconsistent markets
get_market_resolution_statusResolution 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.