Best Polymarket MCP servers for agents in 2026

Match the server to the job. For paper practice against live books, the PyPI binary pm-trader-mcp is the install that cannot spend real funds. For live CLOB tickets, @carbon-copy/polymarket-mcp documents a confirm flag on mutations, while caiovicentino's 45-tool Python server and npx polymarket-agent-mcp expose buy and sell tools once a wallet is in env. For hosted research, 0xinsider listed 69 read-only tools on 3 Nov 2026 and Bitquery hosts 14 Polymarket tools at https://mcp.bitquery.io. Trends MCP is first only when the job is keyword-level bets plus a live Polymarket Top Markets board next to News, Reddit, or GitHub. Official Polymarket docs still ship REST, WebSocket, and SDKs. No MCP page appears in that index.

Which Polymarket MCP should an agent install first?

Install by job, not by star count. GitHub stars on 9 Nov 2026 put caiovicentino/polymarket-mcp-server at 743 and agent-next/polymarket-paper-trader at 502. Those numbers describe attention, not the same product. One places real orders after a clone-and-install. The other papers $10,000 against live books and never holds a key.

Paper trader is the first install for anyone who has not yet decided to sign. PyPI 0.4.13 needs Python 3.10+. Cursor takes this stdio block:

{
  "mcpServers": {
    "polymarket-paper-trader": {
      "command": "uvx",
      "args": ["--from", "polymarket-paper-trader", "pm-trader-mcp"]
    }
  }
}

The README states paper cash, real books, and the official per-match fee curve. Resolution pays $1 per winning share inside the simulator. There is no hosted multi-tenant URL.

Star count is a poor proxy for npx safety. caiovicentino leads GitHub and has no published npm package. The one-command path is a bash installer, not a registry name. demwick's npm package leads dedicated Polymarket MCP downloads on npmjs.com this week (103) even though the repo has 19 stars, and its npm tarball is still 1.7.0 from 7 Aug while GitHub moved on 5 Nov. Prefer git or Docker if the copy-trading loop is the reason for that server.

Why does npx polymarket-mcp open a wallet?

npx -y polymarket-mcp does not install a read-only Gamma browser. On 9 Nov 2026 that command resolved to npm polymarket-mcp 1.0.0, PlayAINetwork/Polymarket-mcp, MIT, 3 GitHub stars, last push 7 Jul 2025. npmjs.com showed 22 weekly downloads. The README lists placeMarketOrder and placeLimitOrder, and it marks PRIVATE_KEY as required. The sample MCP block even leaves "PRIVATE_KEY": "" in env.

Three other products reuse the same words.

suy2014/polymarket-mcp (0 stars, last push 6 Apr 2026) documents a 12-tool read-only server and tells Cursor to run npx -y polymarket-mcp. That JSON does not launch suy2014. Clone the repo and run node dist/index.js. Node 18 or newer. No key on that source tree.

uvx polymarket-mcp is PyPI polymarket-mcp 0.1.3 from Polycool, Python 3.10+, MIT, last week 22 downloads. Seven read-only tools. The advertised GitHub repo polycool/polymarket-mcp returned 404 on 9 Nov 2026. Treat PyPI as the artifact.

PyPI polymarket-mcp-server 0.1.3 from pr1m8/polymarket-mcp is a third binary. Python 3.13+, last week 20 downloads, 0 GitHub stars. Run it with uvx from that package name inside a config block, not as a guessed npx name:

{
  "mcpServers": {
    "polymarket-pr1m8": {
      "command": "uvx",
      "args": ["--from", "polymarket-mcp-server", "polymarket-mcp"]
    }
  }
}

The 0.1.x README says the surface is read-only across Gamma, Data API, and public CLOB. pab1it0/polymarket-mcp (9 stars, 8 tools, last push 7 Mar 2026) is the older Gamma Docker/uv tree. GitHub's license API returned 404 for that repo even though the README claims MIT. The current PyPI name is not pab1it0.

Carbon Copy's global binary is also polymarket-mcp after npm install -g @carbon-copy/polymarket-mcp. Scoped npx is the safe spelling: npx -y @carbon-copy/polymarket-mcp.

Paste registry names, not README copy, into Cursor.

{
  "mcpServers": {
    "polymarket-iqai-readonly": {
      "command": "npx",
      "args": ["-y", "@iqai/mcp-polymarket"]
    }
  }
}

That IQAI block is the published read-only npx path. Trading needs POLYMARKET_PRIVATE_KEY in env on the GitHub README. The ADK-TS docs page still marks FUNDER_ADDRESS and POLYMARKET_PRIVATE_KEY as required, which disagrees with the README's "No" column. Trust the README for data-only startup; add keys only when the agent should sign.

Who actually places CLOB orders from Cursor?

Four maintained servers can submit tickets. They are not interchangeable on safety.

Carbon Copy's docs at docs.carboncopy.inc (accessed 9 Nov 2026) split the surface: public discovery with no secrets, then authenticated place_order / cancel_orders / relayer execute behind env vars. State-changing tools require confirm: true. Default POLYMARKET_CHAIN_ID is 137 (Polygon). Node 20 or newer. npm 0.3.2 last published 30 May 2026. npmjs.com weekly 78. The GitHub URL on the package (CarbonCopyInc/polymarket-mcp) returned 404 the same morning, so the published tarball and Mintlify docs are the inspectable sources.

caiovicentino/polymarket-mcp-server is the star leader: 743 stars, 149 forks, last push 20 Sep 2026, MIT, Python 3.10+. README groups 45 tools (8 discovery, 10 analysis, 12 trading, 8 portfolio, 7 realtime) and documents order-size limits, exposure caps, and a confirmation flow for large orders. Demo mode needs no wallet. Full trading is a local install, not an npm name. Treat README safety claims as maintainer text until the current tree is reviewed.

demwick/polymarket-agent-mcp registers 48 tools, including orders.buy, orders.sell, orders.batch, and monitor.start for copy trading. Default COPY_MODE is preview. DAILY_BUDGET defaults to 20. The HTTP transport warning is explicit: a public /mcp with live trading can drain the wallet from any caller. engines in 1.7.0 ask for Node 20 or newer even though a README badge still says 18+. npmjs.com weekly 103. GitHub is ahead of npm.

IQAI @iqai/mcp-polymarket 0.1.0 ships place_order, place_market_order, cancel_order, cancel_all_orders, and approve_allowances. Read-only npx works with no env. Trading tools wait on the private key. npmjs.com weekly 147, the highest dedicated Polymarket package page count in this set. GitHub lives at BrainDAO/mcp-polymarket (20 stars); the README clone URL IQAIcom/mcp-polymarket 404s.

Keep signer material in environment variables. Carbon Copy's warning matches Polymarket's own CLOB flow: L1 wallet signature, then L2 HMAC headers, as documented at docs.polymarket.com/getting-started/api (accessed 9 Nov 2026). None of these community servers is an official Polymarket product.

How does Trends MCP attach Polymarket to a keyword?

Trends MCP does not list markets, walk an order book, or sign a ticket. It answers two narrower questions: which open events mention this keyword, and which markets sit on the live top board. That is why it sits first for trend research in Cursor and not for execution. The Cursor object lives on Trends MCP for Cursor. Claude's connector is on Trends MCP for Claude.

{
  "mcpServers": {
    "trends-mcp": {
      "url": "https://api.trendsmcp.ai/mcp",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

get_context is the keyword tool. Source must be Polymarket with that capital P. Default limit is 10, max 20. Default days is 7, max 30. comments does not apply; the schema reserves replies for YouTube, TikTok, Instagram, X, Reddit, Bluesky, and Hacker News. One call accepts at most five context sources. all is ten sources and costs ten requests. Each named source costs one request. Polymarket is not a get_growth or get_time_series source.

A 9 Nov 2026 pull used keyword claude, source Polymarket, limit 3, comments 0, days 7. The envelope returned window_days 7, count 3, requests_charged 1. Each item was kind market with engagement.volume_usd and nested outcome odds. Rank 1 was event id 1237249, title "Next Claude Opus Model (5.6+): HLE-Diamond Debut?", volume_usd 55844, published 2026-10-22T20:37:24Z. The payload note is durable: markets are not limited to the lookback window; they are open events. Odds on that morning will be wrong next month. The field names and the window note will not.

get_top_trends is the board. Type must be Polymarket Top Markets. Default limit is 100, which bills 10 requests (one per 10 rows). Set limit 10 for a single request. A 9 Nov 2026 check with limit 5 returned count 5, as_of_ts 2026-11-09T05:03:56.404390+00:00, and requests_charged 1. The ranked titles turn over. The type string does not. Pagination and sort=rank_change are documented on get_top_trends.

llms.txt updated 9 Nov 2026 lists 54 data sources across 27 platforms and five billed tools plus free get_usage. Plans: Free 100 requests/month, Starter $19 / 1,000 (yearly $16 / $192), Pro $49 / 5,000 (yearly $39 / $468), Business $199 / 25,000 (yearly $159 / $1,910). Yearly copy on that file is "2 months free." Failed calls are free. Pair Trends MCP with a CLOB MCP when the agent must both read crowd odds on a name and send an order. Do not expect one server to do both.

What does official Polymarket ship instead of an MCP?

Polymarket's developer index on 9 Nov 2026 lists TypeScript @polymarket/client, Python polymarket-client, and raw REST plus WebSocket. No MCP page sits in docs.polymarket.com/llms.txt. Public market metadata is unauthenticated Gamma:

curl -G "https://gamma-api.polymarket.com/markets" \
  --data-urlencode "closed=false" \
  --data-urlencode "limit=5"

CLOB at https://clob.polymarket.com reads prices and books publicly, then requires L1 plus L2 auth to place or cancel. Data API is https://data-api.polymarket.com. Relayer is https://relayer-v2.polymarket.com. Community MCP servers wrap those hosts. They do not replace the official contract.

Hosted research still earns a slot when the agent should never see a key. 0xinsider's 6 Nov 2026 guide recorded 69 tools on https://api.0xinsider.com/api/v1/mcp, every one readOnlyHint true. tools/list answers without a credential. tools/call returns HTTP 401 and JSON-RPC -32001 until Authorization: Bearer is set. Check current 0xinsider pricing before budgeting; this run did not find a public dollar table that should be quoted. npm @0xinsider/mcp 3.15.0 (the full product, not Polymarket-only) showed 5,027 downloads in the week 1-7 Nov 2026 on the npm downloads API.

Bitquery's Polymarket family is 14 named tools on https://mcp.bitquery.io, OAuth, Streamable HTTP. Docs accessed 9 Nov 2026 say fills trail the clock (worked examples on 21 Sep 2026 were 12 to 15 minutes behind), history starts September 2025, dispute records start 9 Mar 2026, and there is no order-book depth. bitquery.io/pricing (accessed 9 Nov 2026) lists a 7-day trial with 100 MCP credits and no card, Trading MCP at $19/month ($13/month billed yearly) with 25,000 credits and 32 tools, and AI Investigation MCP at $149/month ($100/month billed yearly) with 200,000 credits and 314 tools. Confirm which SKU includes the 14 Polymarket tools before paying. On-chain fills are not a substitute for CLOB depth.

graph-polymarket-mcp 2.1.2 (4 GitHub stars, npm last-week 116 on the downloads API, Node 18+) adds The Graph plus Gamma/CLOB reads and wants GRAPH_API_KEY. Oracle3 (567 GitHub stars, PyPI 1.2.2, last week 33) is a cross-venue engine with 13 MCP tools across Kalshi, Polymarket, and Solana, not a general Polymarket client. Skip both unless that extra surface is the actual job.

FAQ

Is there an official Polymarket MCP server?

No page in the 9 Nov 2026 Polymarket docs index describes one. Official surfaces are the TypeScript SDK @polymarket/client, the Python SDK polymarket-client, Gamma, CLOB, Data API, Relayer, and the WebSocket channels. Community MCP servers wrap those APIs. None of the repositories in this roundup is presented as a Polymarket-owned MCP product.

Can Trends MCP place a Polymarket order?

No. get_context source Polymarket returns open events for a keyword. get_top_trends type Polymarket Top Markets returns a ranked board. Default context limit is 10 (max 20). Board default limit is 100 (1 request per 10 rows). There is no place_order tool. Use Carbon Copy, IQAI, caiovicentino, or demwick for tickets, and keep keys out of prompts.

What does npx polymarket-mcp install?

npm polymarket-mcp 1.0.0 from PlayAINetwork, a July 2025 trading server that wants a Polygon PRIVATE_KEY and exposes placeMarketOrder. It is not suy2014's read-only tree, not Polycool's PyPI package, not pr1m8's polymarket-mcp-server, and not Carbon Copy's scoped package. npmjs.com showed 22 weekly downloads on 9 Nov 2026.

Which server is safest for a first Cursor install?

polymarket-paper-trader. The PyPI 0.4.13 binary pm-trader-mcp papers $10,000 against live books, MIT, 182 downloads last week. For live data with no simulator, IQAI's read-only npx block or Trends MCP's HTTP JSON both start without a wallet. Add a signing server only after the research path is proven.

How much does a hosted Polymarket MCP cost?

Trends MCP Free is 100 requests/month with no card; Starter is $19/month for 1,000. Bitquery's MCP trial is 100 credits for 7 days; paid MCP plans start at $19/month on the pricing page accessed 9 Nov 2026. 0xinsider requires an API key for tools/call; quote a dollar figure only from a current pricing page. Open-source stdio servers have no SKU. Upstream Gamma/CLOB rate limits still apply.

Sources (accessed 9 Nov 2026): Polymarket API, Polymarket docs index, Carbon Copy Polymarket MCP, IQAI Polymarket MCP, Bitquery Polymarket MCP, Bitquery pricing, 0xinsider MCP guide, npmjs.com pages for polymarket-mcp, @carbon-copy/polymarket-mcp, polymarket-agent-mcp, and @iqai/mcp-polymarket, plus GitHub API star and push metadata for the named repos.