polymarket-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@polymarket-mcp show me the top markets by volume"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Polymarket MCP Server
Model Context Protocol server for Polymarket prediction markets. v0.3.0
Query Polymarket markets, events, narratives, arbitrage opportunities, and more — from any MCP-compatible client (Claude Desktop, OpenClaw, Cursor, etc.) OR via HTTP REST.
Zero dependencies. No API key required. MIT license.
Quick Start
Option A: MCP (recommended)
Option B: HTTP (for curl/web/dashboards)
Related MCP server: Polymarket MCP Server
Available Tools
Tool | Description |
top_markets | Top markets by volume (24h or total) with formatted prices |
search_markets | Client-side keyword search across title+description |
get_market | Detailed market info by slug |
top_movers | Biggest price movers with price formatting |
list_events | List events with optional child market details |
market_narratives | Cluster events by theme/narrative with volume analysis |
detect_volume_spikes | Find markets with unusual 24h volume spikes |
find_arbitrage | Discover Yes+No != 100% opportunities |
market_summary | Comprehensive ecosystem snapshot |
Changelog
v0.3.0 (2026-06-26)
HTTP mode: --http PORT starts a REST API at /health, /tools, /call/{tool_name}
HTML status page: GET / shows a human-readable dashboard
CORS headers: All endpoints support cross-origin requests
v0.2.0 (2026-06-26)
Smart price formatting (Yes 52¢ / No 48¢)
Proper client-side search
Retry logic (429, 502, 503, 504)
Connection resilience
Technical Details
Protocol: JSON-RPC 2.0 over stdio (MCP) OR HTTP REST
Dependencies: Zero (Python standard library only)
API: Polymarket Gamma API (public, no key needed)
Python: 3.7+
License: MIT
Configuration with Claude Desktop
Add to claude_desktop_config.json:
Available Tools
9 toolsdetect_volume_spikesC
Detect Polymarket markets with unusual 24h volume
Inputs: limit.
find_arbitrageB
Find arbitrage opportunities where Yes+No != 100%
Inputs: limit, min_spread.
get_marketC
Get detailed info about a specific Polymarket market by slug
Inputs: slug (required).
list_eventsC
List Polymarket events with child markets
Inputs: tag, limit, with_markets.
market_narrativesB
Cluster Polymarket events by theme/narrative
Inputs: limit.
market_summaryA
Get a comprehensive summary of the Polymarket ecosystem right now
Inputs: no named parameters.
search_marketsC
Search Polymarket markets by keyword
Inputs: query (required), limit.
top_marketsC
Top Polymarket markets by 24h volume
Inputs: limit, by_total.
top_moversC
Biggest price movers on Polymarket
Inputs: limit, period.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Each tool has a clearly distinct purpose: detection of volume spikes, arbitrage, specific market details, events listing, narrative clustering, ecosystem summary, keyword search, top markets by volume, and top movers. No two tools overlap in functionality, so an agent can easily distinguish them.
Seven out of nine tools follow a consistent verb_noun pattern (e.g., detect_volume_spikes, get_market, search_markets). Two tools, market_narratives and market_summary, use a noun_noun format, which is a minor deviation but still clear.
With 9 tools, the server provides a broad yet focused set of functionalities for analyzing Polymarket prediction markets. The count is well-scoped for a single-purpose server, neither too few nor too many.
The tools cover key analytical tasks for Polymarket: searching, listing, summarizing, detecting anomalies, and identifying opportunities. For a read-only analysis server, the surface is complete; adding betting or account tools would shift scope.
Maintenance
Related MCP Connectors
Historical tick, order book and settlement data for Polymarket and Predict.fun crypto up/down markets, plus smart-money lists and backtest quotes, over a read-only MCP server.
Polymarket MCP — prediction-market data via Gamma + CLOB + Data public APIs.
Polymarket & Kalshi live prediction market odds aggregator and cross-venue arbitrage scanner MCP.
Hosted MCP server for SEC, FRED, Polymarket, Deribit, OKX, and FMP.
Related MCP Servers
- AlicenseAqualityCmaintenanceA read-only MCP server exposing Polymarket's public prediction-market data. Search markets, read live odds and order books, pull historical probability time-series, and inspect public wallet positions.14MIT
- FlicenseNot gradedqualityDmaintenanceMCP server that exposes Polymarket prediction markets via CLI wrapper. Enables AI agents to discover markets, check prices, and place trades programmatically.-
- FlicenseAqualityCmaintenanceA 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.15-
- AlicenseNot gradedqualityCmaintenanceMCP server for querying and optionally trading across prediction markets (Polymarket, Kalshi, Limitless, Manifold) through a unified API.31MIT