@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

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