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