# 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`:

```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:

```json
{
  "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](https://polymarketscan.org) — real-time Polymarket analytics.