Polymarket MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| POLYMARKET_CACHE_DISABLED | No | Set to true to disable all caching | false |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_eventsC | List and filter Polymarket prediction events. Supports pagination, sorting, and filtering by status/tag. |
| get_eventA | Get a single Polymarket event by ID or slug. Returns full event details including nested markets. |
| get_marketsB | List and filter Polymarket prediction markets. Supports rich filtering by volume, liquidity, dates, tags, and status. Sort by volume descending to find the most active markets. |
| get_marketB | Get a single Polymarket market by ID or slug. Returns full market details including outcomes, prices, volume, and liquidity. |
| searchB | Full-text search across Polymarket events, markets, and profiles. Use this to find markets on any topic. |
| get_tagsA | List all available Polymarket category tags. Use these tags to filter markets and events. |
| get_seriesC | List Polymarket event series (grouped collections of related events). |
| get_series_by_idA | Get a specific Polymarket event series by ID, including all events in the series. |
| get_sportsB | List available sports on Polymarket (e.g. NBA, NFL, EPL, MLB). |
| get_sports_teamsC | List teams for a given sport on Polymarket. |
| get_priceB | Get the current price for a Polymarket token on the given side (buy or sell). Returns the best available price. |
| get_midpointA | Get the midpoint price for a Polymarket token (average of best bid and ask). |
| get_last_trade_priceC | Get the last executed trade price for a Polymarket token. |
| get_order_bookA | Get the full order book (bids and asks) for a Polymarket token. Shows market depth and liquidity at each price level. |
| get_order_booksC | Get order books for multiple Polymarket tokens in a single batch request. |
| get_order_book_summaryB | Get a summarized order book for a Polymarket token: best bid, best ask, and spread. |
| get_clob_marketB | Get CLOB-specific market details by condition ID. Returns tokens, rewards, tick sizes, and trading parameters. |
| get_sampling_marketsB | Get currently sampled Polymarket markets that are eligible for liquidity rewards. |
| get_sampling_simplified_marketsB | Get simplified view of currently sampled Polymarket markets. |
| get_tick_sizeC | Get the minimum tick size (price increment) for a Polymarket token. |
| get_market_tradesC | Get recent trades for a Polymarket market. Shows who traded, which side, size, price, and timestamp. |
| get_market_holdersC | Get top holders/positions for a Polymarket market. Shows the largest positions and who holds them. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| analyze_market | Analyze a Polymarket prediction market in depth — probability, liquidity, volume, order book depth, and top holders. |
| compare_markets | Compare two or more Polymarket prediction markets side-by-side. |
| trending_markets | Find the hottest prediction markets on Polymarket right now. |
| sports_overview | Overview of sports prediction markets on Polymarket. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| tags |
TDQS
Scored across 22 tools
Most tools have distinct purposes, but there is notable overlap between get_event/get_market and get_events/get_markets, which could cause confusion about when to use each. Additionally, get_order_book, get_order_book_summary, and get_midpoint all relate to order book data, creating some redundancy in the set.
All tool names follow a consistent snake_case pattern with a clear 'get_' prefix, making them predictable and easy to parse. The naming scheme is uniform across all 22 tools, with no deviations in style or structure.
With 22 tools, the count is borderline high for a prediction market server, leaning toward heavy. While Polymarket has a complex domain, the tool set includes multiple similar tools (e.g., order book variants) that could have been consolidated, making it feel slightly over-scoped.
The tool set provides comprehensive read-only coverage for exploring Polymarket data, including events, markets, trades, order books, and metadata. However, it lacks write operations (e.g., placing trades or managing positions), which are core to a trading platform, leaving a minor but notable gap for full agent interaction.