Skip to main content
Glama
@igoforth/polymarket-mcp

@igoforth/polymarket-mcp

by igoforth

@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-mcp

Related 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

query_markets

Fluent MarketBuilder — query markets with field selection and presets

list_markets

List markets with filtering

list_events

List events with pagination

get_event

Get event by ID or slug

get_tag

Get tag by ID or slug

list_tags

List all tags

search

Full-text search across markets and events

get_series

Get series details

list_series

List all series

get_sports_metadata

Sports market metadata

get_team

Team details for sports markets

get_profile

Public profile by wallet address

get_comments

Comments on markets/events

get_clarifications

Market clarifications

Orderbook & Pricing (CLOB API)

Tool

Description

get_orderbooks

Get orderbook depth for token(s)

get_price

Current price for a token

get_prices

Batch prices for multiple tokens

get_midpoint

Midpoint price

get_spreads

Bid-ask spreads

get_price_history

Historical price data

get_sampling_markets

Markets available for sampling

get_market_rewards

Market maker reward rates

get_server_time

CLOB server timestamp

User Activity (Data API)

Tool

Description

get_user_activity

Trading activity for an address

get_user_value

Portfolio value

get_positions

Open positions

get_closed_positions

Closed positions

get_trades

Trade history

get_live_volume

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 tools
get_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.

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

    C2.6/5.0

    Scored across 47 tools

    Disambiguation2/5

    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.

    Naming Consistency3/5

    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.

    Tool Count2/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      An 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.
      1
      AGPL 3.0
    • A
      license
      A
      quality
      D
      maintenance
      MCP server for Polymarket prediction markets, enabling search, market details, pricing, and bet analysis through 6 tools, with optional authenticated trading via API key.
      6
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A 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 npm
      MIT