@igoforth/polymarket-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@igoforth/polymarket-mcp list active political markets"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@igoforth/polymarket-mcp
MCP server exposing 47 Polymarket API tools for AI assistants. Covers the full Gamma, CLOB, and Data APIs plus a fluent MarketBuilder for multi-source queries.
Installation
npm install -g @igoforth/polymarket-mcpRelated MCP server: Polymarket MCP Server
Usage
Claude Code
Add to ~/.claude/settings.json:
{
"mcpServers": {
"polymarket": {
"command": "polymarket-mcp"
}
}
}Claude Desktop
{
"mcpServers": {
"polymarket": {
"command": "npx",
"args": ["-y", "@igoforth/polymarket-mcp"]
}
}
}Tools
Market Data (Gamma API)
Tool | Description |
| Fluent MarketBuilder — query markets with field selection and presets |
| List markets with filtering |
| List events with pagination |
| Get event by ID or slug |
| Get tag by ID or slug |
| List all tags |
| Full-text search across markets and events |
| Get series details |
| List all series |
| Sports market metadata |
| Team details for sports markets |
| Public profile by wallet address |
| Comments on markets/events |
| Market clarifications |
Orderbook & Pricing (CLOB API)
Tool | Description |
| Get orderbook depth for token(s) |
| Current price for a token |
| Batch prices for multiple tokens |
| Midpoint price |
| Bid-ask spreads |
| Historical price data |
| Markets available for sampling |
| Market maker reward rates |
| CLOB server timestamp |
User Activity (Data API)
Tool | Description |
| Trading activity for an address |
| Portfolio value |
| Open positions |
| Closed positions |
| Trade history |
| Real-time trading volume |
No API Keys Required
All tools use public Polymarket API endpoints. No authentication needed for read-only market data.
License
MIT
Available Tools
47 toolsget_builders_leaderboardGet Builders LeaderboardC
Get builder rankings by volume.
Inputs: limit, offset, end_date, start_date.
get_builders_volumeGet Builders VolumeC
Get daily volume time-series for builders.
Inputs: timePeriod.
get_closed_positionsGet Closed PositionsC
Get closed positions for a user.
Inputs: user (required), limit, market, offset.
get_comments_by_idGet Comments by IDC
Get comments by comment ID.
Inputs: id (required), get_positions.
get_comments_by_userGet User CommentsC
Get comments by wallet address.
Inputs: user_address (required), limit, offset.
get_current_reward_marketsGet Current Reward MarketsA
Get markets offering liquidity rewards.
Inputs: no named parameters.
get_eventGet Event DetailsC
Get event by numeric ID or URL slug.
Inputs: no named parameters.
get_event_creatorGet Event Creator DetailsB
Get event creator by ID.
Inputs: id (required).
get_event_metadataGet Event MetadataA
Get event metadata (tweets, comments, or tags count).
Inputs: id (required), metric (required).
get_live_volumeGet Live VolumeC
Get live volume for an event.
Inputs: id (required).
get_market_clarificationsGet Market ClarificationsC
Get clarifications about a market's resolution criteria.
Inputs: market_id (required).
get_market_rewardsGet Market RewardsC
Get reward data for market makers on a market.
Inputs: condition_id (required), limit, next_cursor.
get_market_tagsGet Market TagsC
Get tags for a market by numeric ID.
Inputs: id (required).
get_midpointGet Midpoint PriceC
Get midpoint between best bid and ask.
Inputs: token_id (required).
get_orderbooksGet OrderBooksB
Get orderbook(s) for one or more market tokens.
Inputs: token_id (required).
get_other_sizeGet Other SizeC
Get 'Other' size for a neg risk event and user.
Inputs: id (required), user (required).
get_price_historyGet Price HistoryC
Get historical price data for a token.
Inputs: market (required), endTs, startTs, fidelity, +1 more.
get_pricesGet PricesB
Get market prices — all, single token, or batch.
Inputs: side, prices, token_id.
get_public_profileGet Public ProfileB
Get public profile by wallet address.
Inputs: user_address (required).
get_recent_tradesGet Recent TradesC
Get recent trades, optionally filtered by market or user.
Inputs: user, limit, market.
get_revisionsGet Market RevisionsB
Get revision history for a market question.
Inputs: questionID (required), limit.
get_sampling_marketsGet Sampling MarketsC
Get a random sample of markets.
Inputs: next_cursor.
get_sampling_simplified_marketsGet Sampling Simplified MarketsC
Get a random sample of simplified markets.
Inputs: next_cursor.
get_seriesGet Series DetailsB
Get series by ID.
Inputs: id (required).
get_series_metadataGet Series MetadataC
Get series comments count or summary.
Inputs: metric (required), id, slug.
get_server_timeGet Server TimeB
Get CLOB server timestamp.
Inputs: no named parameters.
get_sports_market_typesGet Sports Market TypesB
Get sports market types.
Inputs: no named parameters.
get_sports_metadataGet Sports MetadataC
Get sports metadata.
Inputs: no named parameters.
get_spreadsGet Bid-Ask SpreadsC
Get spreads for multiple tokens.
Inputs: token_ids (required).
get_tagGet Tag DetailsB
Get tag by ID or slug.
Inputs: id, slug.
get_teamGet Team DetailsA
Get sports team by ID.
Inputs: id (required).
get_tradedGet Markets TradedC
Get number of markets a user has traded.
Inputs: user (required).
get_user_activityGet User ActivityC
Get trading activity for a wallet address.
Inputs: user (required), limit, offset.
get_user_positionsGet User PositionsC
Get open positions for a wallet address.
Inputs: user (required), limit, offset.
get_user_valueGet User ValueC
Get total value of a user's positions.
Inputs: user (required), market.
list_commentsList CommentsC
List comments with optional market/event filter.
Inputs: limit, offset, event_id, market_id.
list_event_creatorsList Event CreatorsC
List event creators with pagination.
Inputs: limit, offset.
list_eventsList EventsC
List prediction events with offset or cursor pagination.
Inputs: limit, order, active, cursor, +1 more.
list_marketsList MarketsC
List prediction markets from Polymarket.
Inputs: limit, closed, offset, volume_num_min.
list_seriesList SeriesB
List series with pagination.
Inputs: limit, offset.
list_sport_events_resultsList Sports Event ResultsC
List sports events results with pagination.
Inputs: limit, offset.
list_tagsList TagsA
List all tags with pagination.
Inputs: limit, offset.
list_teamsList Sports TeamsC
List sports teams with pagination.
Inputs: limit, offset.
public_searchPublic SearchC
Search across markets, events, and profiles.
Inputs: q (required), limit_per_type.
query_marketsQuery MarketsA
Get detailed market data with flexible querying. Query single markets by id/condition_id/slug, multiple markets by arrays, or filter by tag. Select specific fields or use presets (pricing, metadata, trading, holders, status) to get only the data you need.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 47 tools
Many tools have unclear boundaries. For example, get_tags_related_to_tag and get_related_tags appear to do the same thing, and get_sampling_markets vs get_sampling_simplified_markets are nearly identical. Price-related tools (get_prices, get_midpoint, get_spreads) also overlap significantly.
The naming pattern is mixed: some tools use list_ (list_markets, list_comments), others use get_ (get_event, get_market_tags), and a few use neither (query_markets, public_search). While most names are readable, the inconsistency makes the API less predictable.
With 47 tools, the server feels overloaded. Many are minor variations (e.g., get_sampling_markets vs get_sampling_simplified_markets, get_related_tags vs get_tags_related_to_tag) that could be merged or removed. The large count increases cognitive load without clear added value.
The server covers a broad range of Polymarket data: events, markets, prices, user positions, comments, tags, sports, and builder analytics. It is almost entirely read-only, which seems intentional, and lacks only minor convenience features like batch queries or combined endpoints.
Maintenance
Related MCP Connectors
Historical tick, order book and settlement data for Polymarket and Predict.fun crypto up/down markets, plus smart-money lists and backtest quotes, over a read-only MCP server.
MCP server for OpenMM — exposes market data, account, trading, and strategy tools to AI agents
MCP server exposing the Backtest360 engine API as tools for AI agents.
Polymarket MCP — prediction-market data via Gamma + CLOB + Data public APIs.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn MCP server that gives AI agents direct access to Polymarket Crypto prediction markets, enriched with live spot prices. Discover markets, analyze order books, paper trade strategies, track activity, and execute live trades — all through natural language.1AGPL 3.0
- AlicenseAqualityDmaintenanceMCP server for Polymarket prediction markets, enabling search, market details, pricing, and bet analysis through 6 tools, with optional authenticated trading via API key.6MIT
- FlicenseNot gradedqualityDmaintenanceMCP server that exposes Polymarket prediction markets via CLI wrapper. Enables AI agents to discover markets, check prices, and place trades programmatically.-
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables seamless integration with Polymarket, providing tools to search markets, fetch events, analyze leaderboards, query user activity, and more via MCP-compatible clients like Claude.46 npmMIT