Polymarket MCP server
Polymarket MCP server — 1-second L2 order books in Cursor and Claude
Query historical Polymarket order book depth from any MCP client — Cursor, Claude Desktop, or custom agents. Full bid/ask ladders at 1-second resolution, not just live midpoints from Polymarket's API.
Install notes verified 2026-08-26.
Setup
Install with npx
No global install. Add @polyorderbooks/mcp-server to your MCP config, set POLYORDERBOOKS_API_KEY, and restart the client. Free Starter keys work at 1s resolution.
{
"mcpServers": {
"polyorderbooks": {
"command": "npx",
"args": ["-y", "@polyorderbooks/mcp-server"],
"env": { "POLYORDERBOOKS_API_KEY": "pob_..." }
}
}
}Package: @polyorderbooks/mcp-server on npm · MCP setup docs · GitHub · Glama directory
MCP tools
| Tool | What it does |
|---|---|
search_series | Recurring families — e.g. btc-up-or-down-5m |
search_events | Event groups that resolve together |
search_markets | Keyword or date-range market discovery |
get_market | One market with outcome tokens and winner |
get_order_book_history | L2 bid/ask ladders over time — not on Polymarket API |
get_price_history | Per-outcome price series |
get_market_metrics | Spread, liquidity, volume time series |
get_usage | Plan, rate limits, and remaining quota |
Why historical L2 via MCP
Polymarket's own API serves current books and price history well. It does not archive full order book depth. Our MCP server exposes what we capture every second — the layer you need for slippage, final-minute liquidity, and settlement microstructure.
Related guides: order book data, historical data overview, 5-minute markets.
FAQ
Does the MCP server work with Cursor and Claude Desktop?
Yes. Add the server to your MCP client config (Cursor .cursor/mcp.json or Claude Desktop claude_desktop_config.json), restart the client, and call tools from chat.
Is there a free tier for MCP queries?
Yes — the Starter plan queries at 1-second resolution with the same data as paid tiers. Paid plans add longer history and higher rate limits, not finer granularity.
What makes this different from other Polymarket MCP servers?
Most wrap Polymarket's live Gamma/CLOB APIs. This server reads our historical archive — full L2 order book ladders at 1-second resolution that Polymarket does not store.