- name
- polymarket-live-markets
- display_name
- Polymarket MCP — Live Markets & Prices
- version
- 1.1.0
- description
- Real-time access to Polymarket prediction markets via the official Gamma API and CLOB v2 order book. Search thousands of markets on politics, crypto, sports, and world events. Get live YES/NO prices pulled directly from the on-chain order book — not cached estimates. Price history with sparklines. Browse by category. Zero credentials required.
- author
- polymarket-mcp
- license
- MIT
- homepage
- runtime
- node
- language
- typescript
- min_node_version
- 18
- tags
- ["polymarket","prediction-markets","finance","crypto","bitcoin","politics","sports","real-time","clob","order-book","trading","markets","data","price-history","sparkline"]
- categories
- ["Finance & Crypto","Data & Research","Real-Time Data"]
- transport
- ["stdio"]
- requires_auth
- false
- read_only
- true
- install
- {"manager":"npm","command":"npm install"}
- scripts
- {"dev":"npm run dev","build":"npm run build","start":"npm start"}
- claude_desktop_config
- {
"mcpServers": {
"polymarket": {
"command": "node",
"args": ["PATH_TO/polymarket-mcp/dist/server.js"]
}
}
}
- tools
- [{"name":"search_markets","description":"Search across all active Polymarket markets by keyword. Uses multi-field relevance scoring across event titles, market questions, and category tags — results ranked by relevance + 24h volume. Optional category filter (e.g. 'crypto', 'politics', 'sports'). Covers politics, crypto, sports, entertainment, science, and more.\n","example":"search_markets(\"bitcoin\")","parameters":[{"name":"query","type":"string","required":true,"description":"Keyword or phrase to search (e.g. \"bitcoin\", \"2028 election\", \"world cup\")"},{"name":"limit","type":"number","required":false,"default":10,"description":"Number of results to return (1–50)"},{"name":"category","type":"string","required":false,"description":"Optional category filter (e.g. \"crypto\", \"politics\", \"sports\", \"nba\")"}]},{"name":"search_by_category","description":"Browse the hottest Polymarket markets by category or topic, sorted by 24h volume. Common categories: politics, crypto, sports, geopolitics, ai, esports, trump, bitcoin, nba, election, finance, entertainment.\n","example":"search_by_category(\"crypto\", 5)","parameters":[{"name":"category","type":"string","required":true,"description":"Category name (e.g. \"politics\", \"crypto\", \"sports\")"},{"name":"limit","type":"number","required":false,"default":10,"description":"Number of results to return (1–50)"}]},{"name":"get_market_details","description":"Get complete details for any Polymarket market: full question text, resolution description, current prices for all outcomes, all-time volume, 24h volume, liquidity depth, status, and end date. Accepts market slugs, event slugs (from search results), or 0x condition IDs.\n","example":"get_market_details(\"will-bitcoin-hit-150k-by-june-30-2026\")","parameters":[{"name":"slugOrId","type":"string","required":true,"description":"Market or event slug from search_markets output, or a 0x-prefixed hex condition ID.\n"}]},{"name":"list_top_markets","description":"List the hottest prediction markets on Polymarket right now, ranked by 24-hour trading volume. Great for discovering what the crowd is actively betting on today — from elections and crypto to sports and geopolitics.\n","example":"list_top_markets(10)","parameters":[{"name":"limit","type":"number","required":false,"default":10,"description":"Number of markets to return (1–50)"}]},{"name":"get_current_prices","description":"Fetch live YES/NO prices directly from the Polymarket CLOB v2 order book. Returns the true midpoint price — (best_bid + best_ask) / 2 — for each outcome, plus the 24-hour price change (▲▼) and the Gamma cache price for comparison. Most accurate real-time pricing available.\n","example":"get_current_prices(\"will-bitcoin-hit-150k-by-june-30-2026\")","parameters":[{"name":"slugOrId","type":"string","required":true,"description":"Market or event slug, or 0x-prefixed condition ID."}]},{"name":"get_price_history","description":"Get historical price data for a market's outcomes from the CLOB v2. Returns open, close, high, low prices, the percentage change, and a Unicode sparkline chart (▁▂▃▄▅▆▇█) showing price movement over time. Periods: 1h (1-min candles), 6h (10-min), 24h (hourly), 7d (daily), 30d (daily).\n","example":"get_price_history(\"will-bitcoin-hit-150k-by-june-30-2026\", \"7d\")","parameters":[{"name":"slugOrId","type":"string","required":true,"description":"Market or event slug, or 0x-prefixed condition ID."},{"name":"period","type":"string","required":false,"default":"24h","description":"Time period: 1h | 6h | 24h | 7d | 30d"}]},{"name":"get_polymarket_stats","description":"Get a platform-wide snapshot of Polymarket activity: total 24-hour trading volume, all-time volume, active liquidity, top market categories by event count, and the 3 hottest markets right now.\n","example":"get_polymarket_stats()","parameters":[]}]
- example_prompts
- ["What are the top Polymarket markets right now?","Search Polymarket for bitcoin markets","Search Polymarket for 2028 US election markets","Search Polymarket for NBA playoffs","Browse crypto markets on Polymarket","Show me the top politics markets","Get details for the FIFA World Cup market","Get live YES/NO prices for will-bitcoin-hit-150k-by-june-30-2026","Show me Bitcoin's price history on Polymarket over the last 7 days","What are the current odds on the Brazil presidential election?","What's the Polymarket odds on Trump and Xi meeting?","Show me a Polymarket platform overview","What are traders betting on today on Polymarket?","Find me prediction markets about AI","What's the market probability for a US recession?","How has the Bitcoin price chart moved on Polymarket this week?"]
- highlights
- ["Live CLOB v2 order-book prices — not stale cached data","24-hour price change indicator (▲▼) for instant trend visibility","Price history sparklines (▁▂▃▄▅▆▇█) for any market and period",{"Smart 3-step slug resolution":"market slug → event slug → condition ID"},"Multi-field relevance scoring (title + questions + tags) for better search",{"Browse by category":"politics, crypto, sports, geopolitics, AI, esports..."},"Keyword search across thousands of active markets","Zero setup — no API key, no wallet, no authentication","Built with TypeScript + official MCP SDK — production quality","Native Node.js fetch — no extra HTTP dependencies"]
