README.md
A production-grade MCP server for Polymarket prediction markets.
polymarket-mcp
A production-grade MCP server for Polymarket prediction markets. Give Claude (or any MCP client) full read access to every public Polymarket API.
Why?
Prediction markets are the best real-time signal for what the world thinks will happen next. This server puts that signal directly into your AI assistant's toolkit — no API keys, no auth tokens, no setup hassle.
23 tools • 5 resources • 4 prompts • Zero config • Zero dependencies beyond the MCP SDK
Quick Start
Option 1: Claude Desktop
Add to your claude_desktop_config.json (Settings > Developer > Edit Config):
{
"mcpServers": {
"polymarket": {
"command": "npx",
"args": ["-y", "@yigit/polymarket-mcp"]
}
}
}
Restart Claude Desktop. Done.
Option 2: Claude Code
claude mcp add polymarket -- npx -y @yigit/polymarket-mcp
Option 3: Build from source
git clone https://github.com/yigitabi5444/yigit_polymarket_mcp.git
cd yigit_polymarket_mcp
npm install && npm run build
node dist/index.js # runs over stdio
Then point your MCP client at the built binary:
{
"mcpServers": {
"polymarket": {
"command": "node",
"args": ["/absolute/path/to/yigit_polymarket_mcp/dist/index.js"]
}
}
}
What Can It Do?
Gamma API — Events & Markets
| Tool | What it does |
|---|---|
get_events |
List/filter events — paginate, sort by volume/liquidity, filter by tag/status |
get_event |
Single event by ID or slug |
get_markets |
List/filter markets with rich filtering (volume, liquidity, dates, tags) |
get_market |
Single market by ID or slug |
search |
Full-text search across events, markets, and profiles |
get_tags |
List all category tags |
get_series |
List event series (grouped collections) |
get_series_by_id |
Get a specific series by ID |
get_sports |
List available sports |
get_sports_teams |
List teams for a sport |
CLOB API — Prices & Order Books
| Tool | What it does |
|---|---|
get_price |
Current price for a token (buy/sell side) |
get_midpoint |
Midpoint price (best bid + best ask / 2) |
get_last_trade_price |
Last executed trade price |
get_price_history |
Historical price time series (configurable interval + fidelity) |
get_order_book |
Full bid/ask depth for a token |
get_order_books |
Batch order books for multiple tokens |
get_order_book_summary |
Best bid, best ask, and spread at a glance |
get_clob_market |
CLOB market details by condition ID |
get_sampling_markets |
Markets eligible for liquidity rewards |
get_sampling_simplified_markets |
Simplified sampled markets |
get_tick_size |
Minimum price increment for a token |
Data API — Trades & Holders
| Tool | What it does |
|---|---|
get_market_trades |
Recent trades for a market |
get_market_holders |
Top holders / position breakdown for a market |
Resources (URI-based access)
| URI Pattern | Description |
|---|---|
market://slug/{slug} |
Market JSON by slug |
event://slug/{slug} |
Event JSON by slug |
market://condition/{id} |
CLOB market by condition ID |
orderbook://token/{id} |
Live order book for a token |
tags://all |
All category tags (cached) |
Prompts (guided workflows)
| Prompt | Description |
|---|---|
analyze_market |
Deep-dive: probability, liquidity, order book depth, top holders |
compare_markets |
Side-by-side comparison of multiple markets |
trending_markets |
Find the hottest markets by volume right now |
sports_overview |
Overview of sports prediction markets |
Architecture
┌─────────────────────────────┐
│ MCP Client │
│ (Claude Desktop / Code) │
└─────────┬───────────────────┘
│ stdio (JSON-RPC)
┌─────────▼───────────────────┐
│ polymarket-mcp │
│ │
│ ┌──────────┐ ┌──────────┐ │
│ │ Tools │ │Resources │ │
│ │ (22) │ │ (5
Tools (9)
get_eventsList and filter events with pagination and sorting options.get_eventRetrieve a single event by ID or slug.get_marketsList and filter markets based on volume, liquidity, dates, and tags.get_marketRetrieve a single market by ID or slug.searchPerform full-text search across events, markets, and profiles.get_priceGet the current price for a specific token.get_order_bookRetrieve full bid/ask depth for a token.get_market_tradesFetch recent trades for a specific market.get_market_holdersGet top holders and position breakdown for a market.Configuration
claude_desktop_config.json
{"mcpServers": {"polymarket": {"command": "npx", "args": ["-y", "@yigit/polymarket-mcp"]}}}Try it
→Analyze the current probability and liquidity for the upcoming US election market.
→Compare the top three trending markets by volume right now.
→What are the latest price trends and order book depth for the Bitcoin price market?
→Find all sports prediction markets related to the current football season.