Polymarket MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Polymarket MCP ServerWho are the top 10 Polymarket wallets by 30-day profit?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Polymarket MCP Server
Polymarket data for AI agents. Plug this into Claude Desktop, Cursor, Cline, or any other MCP-compatible client and ask your agent things like:
"Who are the top 10 Polymarket wallets by 30-day profit?"
"Show me recent BUYs from smart money in the last 30 minutes"
"Pull the latest trades for wallet 0xa5ea13..."
"What's the market info for
mlb-nyy-tor-2026-06-13?"
The server is fully stateless — it pulls everything from public sources (our hosted signed Oracle + Polymarket's public APIs). No local database, no setup, no API keys.
Tools
Tool | What it does |
| Top wallets ranked by realized PnL over the last 30 days |
| Top active markets by volume |
| Recent trades of a specific wallet (live from Polymarket Data API) |
| Market details by slug (active or closed) |
| Live BUYs from top wallets in the last N minutes |
| Current ECDSA-signed Polymarket snapshot |
Related MCP server: Polymarket MCP Server
Resources
polymarket://wallets/top— top 25 wallets (JSON)polymarket://markets/top— top 25 markets (JSON)
Install
Claude Desktop
Edit claude_desktop_config.json (location varies by OS, see Anthropic docs):
{
"mcpServers": {
"polymarket": {
"command": "python",
"args": ["-m", "mcp_server.server"]
}
}
}Restart Claude Desktop. The tools will appear in the tools list.
Cursor
In your project's .cursor/mcp.json:
{
"mcpServers": {
"polymarket": {
"command": "python",
"args": ["-m", "mcp_server.server"]
}
}
}Smithery (one-click)
Find this server in the Smithery catalogue and click Install.
Run as HTTP server
For web agents or Smithery-hosted setups:
python -m mcp_server.server --http --port 8000Endpoint: http://localhost:8000/mcp (streamable HTTP transport).
Data sources
Source | What we read | Auth |
Our Oracle endpoint | Signed snapshot: top markets + top 100 wallets, refreshed every 60 seconds | None |
Polymarket Data API ( | Live wallet trade history | None |
Polymarket Gamma API ( | Market details by slug | None |
The Oracle snapshot is ECDSA-signed (secp256k1). The signer address is published in each response — verify it yourself if you need provenance guarantees.
Example agent prompt (Claude / Cursor)
"Find the top 5 Polymarket wallets by 30-day PnL, then for each pull their last 5 trades and tell me which markets they are accumulating in right now."
The agent will call get_top_wallets, then loop get_wallet_history, then summarise — entirely through the MCP tools, no extra integration needed.
License
MIT. The data is public (Polymarket exposes it through their own APIs); we just package it for AI agents.
Pricing tiers (planned, post-launch)
Free — everything in this README, no rate limits beyond what Polymarket/Cloudflare enforce.
Pro ($9/mo, planned) — own watchlists, webhook delivery, custom signal alerts.
Enterprise ($49/mo, planned) — dedicated endpoint, historical bulk queries, SLA.
Currently everything is free while we onboard early users — open an issue if you want notification when paid tiers launch.
This server cannot be deployed
Maintenance
Related MCP Connectors
Live Polymarket data for agents: markets, insider-scored whale trades, leaderboards, wallet P&L
Polymarket MCP — prediction-market data via Gamma + CLOB public APIs.
Polymarket integrity MCP — 28 tools for wallet risk, whales, UMA scans, SAR/STR reports.
Calibrated world model for AI agents. 40 tools: world state, markets, trading. Kalshi + Polymarket.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables access to Polymarket's prediction markets for analyzing market probabilities, trading activity, and event outcomes across politics, sports, crypto, and other categories through natural language queries.1610MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to query Polymarket prediction markets, accessing real-time odds, market data, price history, order books, and trending markets across categories like politics, crypto, and sports through natural language.165MIT
- AlicenseBqualityNot gradedmaintenanceEnables AI agents to interact with the Polymarket prediction market platform to discover markets, analyze real-time pricing, and monitor public portfolio data. It provides comprehensive access to market analytics, implied probabilities, and order books through the Model Context Protocol.5916-
- AlicenseBqualityDmaintenanceEnables comprehensive read access to Polymarket prediction market data, including live prices, order books, and market statistics. It allows AI assistants to analyze events, search markets, and monitor real-time signals without requiring API keys or authentication.221MIT