Polymarket MCP Server
The Bitquery MCP server gives an AI client 14 tools for Polymarket data. You ask a question in Claude, ChatGPT, Cursor, VS Code or Codex, the agent picks a tool, and rows come back from Bitquery's on-chain index of Polymarket on Polygon.
It reads data only. It cannot place, change or cancel an order. To trade, use Polymarket's own CLOB API; to research markets, wallets and odds, use this.
claude mcp add --transport http bitquery https://mcp.bitquery.io
Other clients take the same URL. Steps for each are in the MCP server install guide.
Every figure on this page came from a call to the production server on 21 September 2026, between 09:00 and 09:10 UTC. Polymarket moves fast, so your numbers will differ.
What can I ask?
Which markets are people trading right now?
"What are the five most traded Polymarket markets in the last 24 hours?"
The agent calls polymarket_top_markets.
| # | Market | 24h volume | Orders | Wallets |
|---|---|---|---|---|
| 1 | Colts vs. Chiefs | $4,114,943 | 9,124 | 292 |
| 2 | Will United Russia (ER) gain the most seats in the next Russian parliamentary election? | $4,065,436 | 8,532 | 565 |
| 3 | Will Manchester City FC win on 2026-09-20? | $1,918,415 | 5,523 | 386 |
| 4 | Eagles vs. Titans | $1,800,372 | 4,075 | 188 |
| 5 | Packers vs. Jets | $1,666,912 | 4,181 | 190 |
The first row of every answer states the window that was ranked and how far the data trails the clock. On this call it was 14 minutes behind. A short window can therefore look quieter than it was, and the tool says so instead of reporting an empty market.
What are the odds on a market I only know by name?
"Find the open Polymarket markets about the Fed rate, then give me the odds on the first one."
Two calls. polymarket_find_markets with the text "Fed rate" returned three open markets, all created on 16 September 2026: "Another Fed rate hike in 2026?", "Fed rate cut by July 2027 meeting?" and "Fed rate cut by January 2027 meeting?". Then polymarket_market_odds on the first:
| Outcome | Price | Implied probability | Lifetime volume |
|---|---|---|---|
| Yes | 0.86 | 86% | $24,260 |
| No | 0.15 | 15% | $8,783 |
A price is dollars per share between 0 and 1, which is the market's own probability. The two sides add up to 1.01 here because the last fill on each side happened at a different minute. When one side's last trade is old, ask for the 24-hour VWAP, which the same tool returns.
Search text is a plain substring. Asking for "Fed" alone also returned tennis markets for a player named Fedor. Give the agent two words when one is ambiguous.
How did the odds move?
"Show the daily close for Yes on the United Russia market over the last week."
polymarket_market_price_history with a one-day interval:
| Day (UTC) | Close | Volume |
|---|---|---|
| 15 Sep | 0.77 | $170,235 |
| 16 Sep | 0.73 | $474,884 |
| 17 Sep | 0.76 | $183,599 |
| 18 Sep | 0.83 | $833,802 |
| 19 Sep | 0.81 | $1,163,964 |
| 20 Sep | 0.985 | $3,528,998 |
| 21 Sep (to 09:00) | 0.998 | $544,109 |
Volume tripled on the day the price went from 0.81 to 0.985. Intervals run from one second to one day, and days with no trades are left out instead of being filled in.
Who is behind the volume?
"Who traded the most in that market, and is the top wallet a directional bettor or a market maker?"
polymarket_top_traders for the one market, over its whole history:
| Wallet | Volume | Bought | Sold | Orders |
|---|---|---|---|---|
0xf2f6…5817 | $934,582 | $608,832 | $325,750 | 1,700 |
0x369f…873e | $701,366 | $421,191 | $280,175 | 498 |
0x6575…b198 | $570,815 | $570,815 | $0 | 364 |
0x44c1…ebc1 | $414,423 | $414,423 | $0 | 102 |
0xc021…1fa8 | $413,220 | $297,140 | $116,080 | 511 |
This list ranks by dollars traded. It says nothing about profit. The follow-up call shows why that matters: polymarket_trader_summary on the top wallet returns 51,391 lifetime orders across 1,237 markets and $19.55 million traded, and 48,736 of those orders (95%) were resting orders on the book. That is the footprint of a market maker. Wallets three and four are the opposite: buys only, and both placed their first order in this market within the last week (16 and 18 September).
Where are the big fills?
"Show the latest fills above $10,000 in that market."
polymarket_market_trades with a minimum size, newest four:
| Time (UTC) | Wallet | Side | Price | Size |
|---|---|---|---|---|
| 08:32:02 | 0xc021…1fa8 | sell Yes | 0.998 | $49,900 |
| 08:32:02 | 0xb24c…eefe | sell Yes | 0.998 | $21,153 |
| 07:51:50 | 0xb24c…eefe | sell Yes | 0.997 | $13,757 |
| 06:53:51 | 0xe25b…0f1b | sell Yes | 0.997 | $60,782 |
Read side and outcome together. Buying No is the same bet as selling Yes. Most fills on a busy market are under a dollar, so a size floor of $100 or $1,000 is what turns the tape into something readable.
Was a resolution challenged?
"Which Polymarket outcomes were disputed in the last day?"
The four newest rows from polymarket_market_disputes fell between 08:27 and 08:31 UTC, all on one tennis match (M15 Baku, Aleshchev vs Skvortcov) and its set-handicap and total-sets markets. Two wallets raised them, and all four were against answers proposed by the same address. A dispute restarts resolution; it is not a verdict, and the market often settles to the same outcome afterwards.
Challenge records start on 9 March 2026. For an older market an empty answer means "not covered", and the tool's own text tells the agent to say so.
All 14 Polymarket tools
| Tool | Use it for |
|---|---|
polymarket_find_markets | Find markets by title text or category and get their question id |
polymarket_market_info | One market's detail: outcome tokens, oracle, collateral, resolution rules |
polymarket_market_odds | Current price and implied probability per outcome, or as of a past moment |
polymarket_market_price_history | OHLC, VWAP and volume per interval, 1 second to 1 day |
polymarket_market_trades | Individual fills, newest first, with a size floor and a per-wallet filter |
polymarket_market_events | Created and resolved lifecycle events |
polymarket_market_disputes | Challenged answers and rule changes after launch |
polymarket_top_markets | Markets ranked by volume, orders, wallets or fees in a window |
polymarket_top_traders | Wallets ranked by volume, across all markets or inside one |
polymarket_trader_summary | One wallet's lifetime card: first and last trade, volume, markets, maker share |
polymarket_trader_activity | One wallet's breakdown by market and outcome |
polymarket_trader_positions | What a wallet still holds |
polymarket_outcome_holders | Who holds an outcome token |
polymarket_settlements | Redemptions, splits and merges |
What to know before you rely on it
- Read-only. No order placement, no order book depth. Fills are settled on-chain orders.
- A few minutes behind. Calls on this page trailed the clock by 12 to 15 minutes. Every answer reports its own lag.
- History starts in September 2025. A wallet whose "first trade" is 1 September 2025 may have traded earlier. Dispute records start on 9 March 2026.
- No profit and loss in the rankings.
polymarket_top_tradersis volume only. - Collateral changed in 2026. Older fills settle in USDC, newer ones in pUSD. The tools report which one each market used.
MCP, GraphQL or the official API?
| You want to | Use |
|---|---|
| Place or cancel orders, read the order book | Polymarket's CLOB API |
| Ask questions in a chat or let an agent research a market | This MCP server |
| Build a dashboard, alert or backfill in code | The Bitquery Polymarket GraphQL API, with WebSocket and Kafka streams |
| Load full history into a warehouse | Polymarket Parquet exports |
Plans and the trial are on the Bitquery MCP server page.
Frequently Asked Questions
Is there an MCP server for Polymarket?
Yes. The hosted Bitquery MCP server at https://mcp.bitquery.io includes 14 Polymarket tools covering markets, odds, price history, fills, wallets, settlements and disputes. It connects to Claude, ChatGPT, Cursor, VS Code and Codex over Streamable HTTP with an OAuth login.
Can the Polymarket MCP server place trades?
No. It is read-only. It reads settled on-chain orders from Bitquery's index. To place or cancel orders use Polymarket's own CLOB API.
How fresh is the data?
Orders usually appear within half an hour. The calls shown on this page were 12 to 15 minutes behind the clock, and every answer states its own lag.
How far back does it go?
Market and trade history starts in September 2025. Records of disputed resolutions start on 9 March 2026.
Does it show which wallets are profitable?
The ranking tools order wallets by dollars traded, with no profit figure. A wallet at the top is often a market maker. Use the per-wallet tools to see buys, sells, maker share and open positions.
Do I need an API key?
No. You add the server URL to your client and sign in once with a Bitquery account in the browser.
Ready to run this in production?
Get an API key and run these queries in minutes, or talk to us about plans and enterprise delivery.