← all repositories
caiovicentino/polymarket-mcp-server

Claude gets a wallet and a prediction-market habit

This MCP server exposes 45 tools that let Claude research, analyze, and trade on Polymarket through natural language, wrapped in configurable safety limits to prevent runaway positions.

597 stars Python AgentsDomain Apps
polymarket-mcp-server
Not currently ranked — collecting fresh signals.
star history

What it does

This MCP server plugs Claude into Polymarket, exposing 45 tools that let an agent browse prediction markets, read order-book depth, place limit and market orders, and track portfolio P&L. It acts as a translation layer between natural-language intent and Polymarket’s Polygon-based API, complete with a local web dashboard for monitoring and a read-only demo mode that works without a wallet.

The interesting bit

What saves it from being expensive glue code is the safety harness: configurable order-size limits, exposure caps, spread tolerances, and a confirmation gate for large trades. The server also handles the unglamorous but critical bits—EIP-712 order signing, token-bucket rate limiting, and auto-reconnecting WebSockets—so the LLM isn’t left holding raw private keys unsupervised.

Key highlights

  • 45 tools across five categories: market discovery, analysis, trading, portfolio management, and real-time WebSocket feeds
  • Supports advanced order types (GTC, GTD, FOK, FAK), batch submission, and AI-suggested pricing strategies
  • Built-in risk controls including position limits, liquidity validation, and a confirmation flow for large orders
  • Demo mode offers full read-only market analysis without requiring a Polygon wallet
  • Local web dashboard for real-time monitoring, safety-limit tuning, and market browsing

Caveats

  • Full trading requires handing your Polygon private key to the server, which the README documents plainly but is still a trust assumption worth auditing
  • Claims of “AI-powered” analysis and “enterprise-grade” safety are the author’s own descriptions, with no independent benchmarks or third-party audit cited in the sources

Verdict

Worth a look if you want to experiment with LLM-driven trading bots on prediction markets; avoid it if you are not comfortable storing private keys in a local Python process or if you need battle-tested, audited infrastructure.

Frequently asked

What is caiovicentino/polymarket-mcp-server?
This MCP server exposes 45 tools that let Claude research, analyze, and trade on Polymarket through natural language, wrapped in configurable safety limits to prevent runaway positions.
Is polymarket-mcp-server open source?
Yes — caiovicentino/polymarket-mcp-server is open source, released under the MIT license.
What language is polymarket-mcp-server written in?
caiovicentino/polymarket-mcp-server is primarily written in Python.
How popular is polymarket-mcp-server?
caiovicentino/polymarket-mcp-server has 597 stars on GitHub.
Where can I find polymarket-mcp-server?
caiovicentino/polymarket-mcp-server is on GitHub at https://github.com/caiovicentino/polymarket-mcp-server.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.