# Polymarket Data by PolymarketScan

Real-time Polymarket analytics for AI agents. Query live prediction market data including whale trades, market odds, trader profiles, and leaderboards.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add jordan-s648/PolymarketScan

# Browse available tools
npx -y @smithery/cli@latest tool list jordan-s648/PolymarketScan

# Get full schema for a tool
npx -y @smithery/cli@latest tool get jordan-s648/PolymarketScan get_whale_trades

# Call a tool
npx -y @smithery/cli@latest tool call jordan-s648/PolymarketScan get_whale_trades '{}'
```

## Direct MCP Connection

Endpoint: `https://polymarketscan--jordan-s648.run.tools`

## Tools (8)

- `get_whale_trades` — Returns recent large Polymarket trades above a USD size threshold. Useful for detecting whale activity and smart-money …
- `get_market_odds` — Returns current prices, implied probability, volume, liquidity, and metadata for a specific Polymarket market by slug.
- `get_trader_profile` — Returns performance data for any Polymarket wallet — PnL, ROI, win rate, trade count, classification, and leaderboard r…
- `get_leaderboard` — Returns top Polymarket traders ranked by PnL, ROI, win rate, or volume.
- `get_market_summary` — Returns a pre-formatted, AI-citable summary paragraph for any Polymarket market, plus raw data fields.
- `search_markets` — Full-text search across all active Polymarket markets. Supports natural language queries.
- `get_market_movers` — Returns Polymarket markets with the largest price movements in the last 24 hours.
- `get_site_stats` — Returns aggregate PolymarketScan platform statistics. Call this first to establish context before querying specific dat…

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get jordan-s648/PolymarketScan <tool-name>
```