polymarket-mcp
MCP server that exposes Polymarket prediction market data to AI agents.
Community: Submitted by a user or imported; check the owner before granting accessOnlineNo sign-inGlobalFreeRead-only
What it can do
- Search Markets: Search Polymarket markets by title or description. Returns matching markets with: current price, liquidity, volume, end date, and active status.
- Get Market Details: Get full details for a single market — outcomes, prices, volume, liquidity, resolution source, token IDs, and trading parameters. A 'market' is an individual Yes/No question inside
- Get Trending Markets: Get trending Polymarket events ranked by trading activity. Returns active events with: slug, 24h volume, total volume, liquidity, end date, and active status. Use tag_slug to fil
What data it sees
Do you need an account
No: the server works without sign-in
MCP server that exposes Polymarket prediction market data to AI agents. Tools wrap Polymarket's public Gamma (market discovery) and Data (positions, portfolio, leaderboard) APIs.
Server tool list (7)
Raw names from tools/list. Only developers need these.
| search_markets | Search Polymarket markets by title or description. Returns matching markets with: current price, liquidity, volume, end date, and active status. |
| get_market_details | Get full details for a single market — outcomes, prices, volume, liquidity, resolution source, token IDs, and trading parameters. A 'market' is an individual Yes/No question inside an event. |
| get_trending_markets | Get trending Polymarket events ranked by trading activity. Returns active events with: slug, 24h volume, total volume, liquidity, end date, and active status. Use tag_slug to filter by category (e.g. politics, crypto, sports). |
| get_market_holders | Get the top holders for a Polymarket market, grouped by outcome (Yes/No). Provide a condition_id, slug, or Polymarket market URL. Use get_market_details to find the condition_id for a market. |
| get_user_positions | Get current positions for a Polymarket wallet address. Returns each position with: current price, position size, average entry price, current value, and the market it belongs to. |
| get_user_performance | Get a user's trading performance summary: total positions value, volume, P&L across all positions, and their rank on the Polymarket leaderboard. Combines /value (portfolio worth) and /v1/leaderboard (rank + PnL stats). |
| get_leaderboard | Get top Polymarket traders ranked by P&L or volume. Returns rank, username, wallet address, P&L, and trading volume. Distinct from get_user_performance, which looks up a single wallet. |