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
Your agent needs the crowd's number — live odds on elections, policy, macro prints and sport, from the venues where people put money behind the opinion. **What you can ask for** • "What are the current odds on this event?" • "List the open markets on this topic across both venues." • "Show recent trades and how the price moved." • "What is the implied probability now versus a week ago?" **How to use it** Point any MCP client at https://mcp.aisa.one/prediction-market-data/mcp and sign in with OAuth — there is no key to create or paste. 5 tools: Kalshi markets and trades, Polymarket markets, events and activity. **Why this rather than the source** Both venues in one shape, so the same question can be priced twice. **It is also a door to the rest** The same login reaches 26 sources and 580+ operations. Read the odds here, then ask the same agent for the market data or the news behind them — without adding a second server. **What it costs** Finding and inspecting an operation is free. Running one is billed per call at API prices, with no seat and no monthly minimum, and every call takes max_price_usd so an agent cannot overspend by accident. **Where else it reaches** https://mcp.aisa.one/finance/mcp for equities, crypto and prediction markets in one place.
Polymarket rule research. ChatGPT/Claude OAuth or MCPize; approved API access required.
Live Polymarket data for agents: markets, insider-scored whale trades, leaderboards, wallet P&L
Polymarket MCP — prediction-market data via Gamma + CLOB public APIs.
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.21 npm10MIT
- 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.21 npm5MIT
- 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.5921 npm-
- 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