reviews11 min read2d ago

Polymarket MCP Server Review 2026: Prediction Markets for AI Agents

Hands-on review of the Polymarket MCP Server by aryankeluskar (40K+ Smithery uses): seven tools, zero auth, free forever. How to wire live prediction-market odds into Claude, Cursor and Windsurf for AI research workflows.

Polymarket MCP Server Review 2026: Prediction Markets for AI Agents
polymarket mcpprediction marketsai research2026
Polymarket MCP Server Review 2026 — prediction markets for AI agents

TL;DR — Polymarket MCP Review 2026

The Polymarket MCP Server by aryankeluskar is the 40,000-install darling of Smithery for one simple reason: it turns the world's largest prediction market into a set of natural-language tools any AI agent can call. Seven read-only tools, zero authentication, and a live pipe into $3.2B quarterly trading volume. If you want Claude or Cursor to answer "what are the market odds on X?" with real money-weighted data instead of vibes, this is the first MCP you install.

★★★★☆ 4.3/5 Install from Smithery →

Table of Contents

  1. What is the Polymarket MCP?
  2. Six Features That Matter
  3. How to Install and Use It
  4. Pricing
  5. Pros and Cons
  6. Alternatives Compared
  7. FAQ
  8. Final Verdict

What is the Polymarket MCP?

If you have spent any time running AI research workflows in 2026, you have almost certainly hit the moment where you want a model to cite a probability instead of guessing one. "How likely is OpenAI to ship GPT-6 by Q3?" "What is the market saying about the Fed cutting rates in June?" "Which lab has the highest implied odds of the best model at end of year?" LLMs are terrible at this on their own — they hallucinate probabilities, or they parrot stale headlines. Polymarket MCP fixes that problem permanently.

Built by aryankeluskar and listed on Smithery as one of the most-installed finance-adjacent MCPs (40,000+ uses and climbing), this server is a clean bridge between an MCP-speaking client — Claude Code, Cursor, Windsurf, Continue, whatever — and Polymarket's Gamma Markets + Data APIs. It exposes seven tools that cover the discovery, inspection, and analysis workflow end-to-end, all without ever asking you for an API key.

The context: Polymarket itself is the world's largest prediction market. By April 2026 it is clearing roughly $3.2B per quarter in trading volume across politics, sports, crypto, AI, and macroeconomics, with 99 active AI markets alone. Every contract resolves to 0 or 1 dollars, so the price between 0 and 1 is a liquidity-weighted probability. That is the signal you want piped into your agent — and that is exactly what this MCP delivers.

Polymarket homepage showing live prediction markets
Polymarket.com — the live market data this MCP wraps.

Six Features That Matter

Polymarket MCP features overview — browse markets, get odds, track events, search topics, price history, resolutions

1. Browse Markets with Smart Filters

The search_markets tool lets you filter Polymarket's active markets by tag, volume floor, liquidity threshold, and activity. Ask Claude "show me AI markets over $500K volume" and it slices through 16K+ markets in milliseconds. This is the single biggest time-saver versus hitting the raw REST API — you do not need to memorise filter params.

2. Live YES/NO Odds via get_market

The get_market tool returns the current YES/NO price, volume, liquidity, open interest, resolution source, and expiry — everything an agent needs to render a probability card. Prices update in real time against Polymarket's on-chain order book, so you are not looking at a 5-minute cache.

3. Track Related Events

Polymarket groups related markets into events (e.g. "2028 US Presidential Election" is one event containing markets for each candidate). The search_events and get_event tools return the whole cluster with volume-weighted probabilities, saving you from stitching together individual markets. This is invaluable for election night dashboards and multi-outcome contests.

4. Discover Topics via list_tags

The list_tags tool surfaces every active taxonomy tag — "ai", "elections", "crypto", "sports", "macro" — so agents can do top-down discovery before drilling in. It is also how you power autocomplete in any app built on top of this MCP.

5. Price History and Recent Trades

The get_trades tool pulls recent trade history for any market, giving you the pattern Claude needs to write things like "probability jumped from 43% to 61% in the last two hours on 4,200 YES trades." This is where prediction markets quietly beat news sentiment — traders vote with money, not headlines.

6. One-Shot Market Analysis

The analyze_market tool is a composite endpoint — it returns probabilities, volume, liquidity, trader concentration, and a rough "market health" score. Hand it a single market ID and the agent gets everything it needs for a narrative briefing in one call. Fewer round trips, lower token spend.

Polymarket markets page showing live events and probabilities
The markets page the MCP wraps — 16K+ contracts across politics, sports, crypto, AI, macro.

How to Install and Use It

There are two install paths and both are short. Smithery is the fastest, manual is the one you want if you need to pin a specific commit or run it behind a proxy.

Option A — Smithery one-liner (recommended)

# Claude Desktop / Claude Code
npx -y @smithery/cli install @aryankeluskar/polymarket-mcp --client claude

# Cursor
npx -y @smithery/cli install @aryankeluskar/polymarket-mcp --client cursor

# Windsurf
npx -y @smithery/cli install @aryankeluskar/polymarket-mcp --client windsurf

Smithery auto-writes the server config into your client's MCP file. Restart the client and the seven Polymarket tools appear in the tool list. No API key prompts, no OAuth.

Option B — Manual install

git clone https://github.com/aryankeluskar/polymarket-mcp.git
cd polymarket-mcp
npm install
npm run build

# Claude Code config (~/.claude.json or project .mcp.json)
{
  "mcpServers": {
    "polymarket": {
      "command": "node",
      "args": ["/absolute/path/to/polymarket-mcp/dist/index.js"]
    }
  }
}
Smithery page for the Polymarket MCP server showing install commands
Smithery registry page — 40K+ installs make this the #1 prediction-market MCP.

How the workflow feels day-to-day

Polymarket MCP workflow from user prompt through MCP server to Polymarket API

In practice, you type "what's the market saying about the Fed cutting in June?" into Claude. Claude reads the tool list, picks search_markets with a "macro" tag filter, then get_market on the top hit. You get back a one-paragraph summary with the current implied probability, 24-hour volume, and a note on trend direction. Elapsed time: under four seconds in my runs.

Pricing

Polymarket MCP pricing — free forever

Free. The MCP server is MIT-licensed open source, the Polymarket Gamma and Data APIs it calls are free and unauthenticated for read-only use, and there is no rate-limit ceiling that will bite a casual user. The only thing that costs money is if you want to actually trade on Polymarket — and this MCP does not do that. It is strictly read-only, which is the correct choice for 99% of research and briefing workflows.

Two soft costs worth naming: (1) your own LLM token spend (a full market-discovery run is usually under 3K tokens per turn); (2) if you hammer the API in a production setting, Polymarket does apply IP-level throttling, so add a small cache layer in front if you scale.

Polymarket MCP by the numbers: 40K+ Smithery uses, 7 tools, $3.2B quarterly volume, 99 active AI markets

Pros and Cons

✓ Pros

  • Zero auth, free forever. No API key dance, no quota limits for normal use.
  • Seven tools cover the full loop. Discover, inspect, analyse — no REST wrapper needed.
  • 40K+ Smithery installs. Battle-tested at scale; community knows the quirks.
  • Real-time data. Straight from Polymarket's live order book, not a 5-minute cache.
  • MCP-native. Works in Claude Code, Cursor, Windsurf, Continue, and every other client.
  • Read-only by design. Can't burn your bankroll on a hallucination.

✗ Cons

  • No trading tools. If you want autonomous execution, use a different fork.
  • US geo-restriction. Polymarket blocks US IPs from its frontend; the MCP still reads data but trading is not permitted.
  • Thin error messages. Some edge-case tool failures return generic JSON errors.
  • No historical WebSocket stream. For tick-level data you still need the raw Polymarket WebSocket.
  • One-maintainer risk. Active but solo-maintained — pin your version in production.

Alternatives Compared

Polymarket MCP vs Metaculus vs Manifold vs Kalshi — 8-feature comparison

Metaculus is the longstanding forecasting community with impressive calibration, but it has no cash markets and no official MCP — you'd need to wrap their REST yourself. Great for long-horizon research questions, weak for real-time signal.

Manifold Markets runs on play money ("mana"), which means lower-stakes odds and thinner liquidity, but it has more creative markets and a great REST API. A handful of community MCPs exist but none approach 40K installs.

Kalshi is Polymarket's CFTC-regulated US-facing rival, with real cash markets and a clean API — but it requires an authenticated account key and no first-class MCP. Best pick if you actually want to trade from a US jurisdiction.

Other Polymarket MCPs: berlinbra/polymarket-mcp is a simpler 4-tool read-only build; caiovicentino/polymarket-mcp-server is a 45-tool monster with trading support and WebSocket monitoring; IQAIcom/mcp-polymarket targets the IQ AI agent ecosystem. The aryankeluskar build hits the sweet spot for research: enough power to cover the workflow, few enough tools that LLMs pick the right one without agonising.

aryankeluskar/polymarket-mcp GitHub repository
The GitHub repo — check the README for the latest tool definitions and examples.

FAQ

What is the Polymarket MCP server?

An open-source MCP server by aryankeluskar that exposes seven Polymarket tools to any MCP client. It wraps Polymarket's Gamma Markets and Data APIs so Claude, Cursor, or Windsurf can browse markets, fetch live odds, track events, and pull trade history through natural-language prompts instead of REST calls.

Is the Polymarket MCP free?

Yes. The MCP is MIT-licensed and Polymarket's public read APIs don't require authentication. You pay nothing to the MCP and nothing to Polymarket for read access — only your LLM token bill applies.

How do I install Polymarket MCP?

Use Smithery: npx -y @smithery/cli install @aryankeluskar/polymarket-mcp --client claude. Swap the client flag for Cursor, Windsurf, etc. Restart your client and you're in.

Does Polymarket MCP let AI agents place bets?

No. The aryankeluskar build is read-only by design. If you want autonomous trading, look at caiovicentino/polymarket-mcp-server (45 tools, trading, WebSockets) or Polymarket's own agents repo.

How is it different from hitting the Polymarket REST API directly?

The MCP wraps the REST in a semantic tool layer LLMs reason about natively. Instead of memorising endpoints and pagination, the agent picks the right tool from natural-language descriptions. You save hours of SDK integration for research and briefing workflows.

What can I actually build with it?

Daily market briefings, election trackers, crypto sentiment dashboards, AI-model-race watchers, Discord probability bots, and research assistants that blend news sentiment with market-implied probabilities. Because it works in any MCP client, you can research in Claude Code and ship the same logic in Cursor.

Is it safe to let an AI agent read prediction markets?

Yes. The aryankeluskar server is read-only, so there's no way an agent can move money. No private keys, no wallet signing. Worst case is stale or malformed data. Always pin the MCP version and audit the tool list before trusting outputs in high-stakes workflows.

Polymarket developer documentation site
Polymarket developer docs — useful context for understanding the underlying Gamma and Data APIs.

Final Verdict

The Polymarket MCP by aryankeluskar earns a 4.3/5. It does exactly one thing — expose the world's largest prediction market to any MCP client — and it does it without friction. Zero auth, seven well-scoped tools, 40,000 installs of proof that it works, and a real-time pipe into $3.2B/quarter of money-weighted probabilities. The half-point I dock is for the lack of trading tools (a fair design choice, but some users want one server that can do both), US geo-restrictions on Polymarket itself, and the standard one-maintainer risk every small MCP carries.

For anyone building AI research agents, market briefings, or probability-aware dashboards in 2026, this is a five-minute install that upgrades every subsequent prompt. Put it in your stack today.

Want the Premium v2 Prediction Stack?

Skiln Premium bundles the Polymarket MCP, Kalshi wrapper, Metaculus connector, and our curated Prediction-Markets-for-AI workflow pack — pre-configured Claude skills, Cursor snippets, and Discord briefing templates. Everything you need to turn prediction markets into an agentic data source in under an hour.

Get Skiln Premium v2 →

Reviewed by Wayne MacDonald — AI Tools Editor at Skiln. Last updated April 17, 2026. No affiliation with Polymarket, aryankeluskar, or Smithery; review based on hands-on testing against the live April 2026 build.

Frequently Asked Questions

What is the Polymarket MCP server?
Polymarket MCP is an open-source Model Context Protocol server by aryankeluskar that lets AI agents query Polymarket, the world's largest prediction market. It exposes seven tools (search_markets, get_market, search_events, get_event, list_tags, get_trades, analyze_market) so Claude or Cursor can fetch live odds, volume and event data through natural language.
Is the Polymarket MCP free?
Yes. The MCP server is MIT-licensed open source and Polymarket's public Gamma and Data APIs are free and unauthenticated for read-only market data. You only need a Polymarket account if you plan to place real trades and this MCP is strictly read-only.
How do I install Polymarket MCP?
The fastest path is Smithery: npx -y @smithery/cli install @aryankeluskar/polymarket-mcp --client claude. Swap --client for cursor or windsurf for other clients. For manual install clone github.com/aryankeluskar/polymarket-mcp, run npm install, and point your MCP client at the local build.
Does Polymarket MCP let AI agents place bets?
No. The aryankeluskar build is strictly read-only. It surfaces market discovery, odds, volume, event grouping, trades and analytics. For autonomous trading see caiovicentino/polymarket-mcp-server or Polymarket's own agents repository.
How is it different from hitting the Polymarket REST API directly?
The MCP wraps Polymarket's Gamma and Data APIs in a semantic tool layer LLMs reason about natively. Instead of memorising endpoints, field names and pagination, Claude picks the right tool from natural-language descriptions, passes structured arguments and gets AI-friendly JSON back.
What can I actually build with the Polymarket MCP?
Daily market briefings, election trackers, crypto sentiment dashboards, AI-model-race watchers, Discord probability bots and research assistants that blend qualitative news with live market-implied probabilities. Because it works in any MCP client, the same server powers both Claude Code analysis and Cursor app builds.
Is it safe to let an AI agent read prediction markets?
Yes. The aryankeluskar server is read-only so worst case is stale data or a malformed response. It holds no private keys, signs no transactions and cannot spend funds. Always pin the MCP server version and audit the tool list before trusting outputs for high-stakes decisions.

Get the Skiln weekly

The best new Claude skills, MCP servers, and tutorials. One email a week, no spam.