Polymarket MCP Server
The simplest way to query Polymarket prediction-market data with AI agents.
Built by Polycool — track & copy top Polymarket traders in one tap.
What is this?
A lightweight Model Context Protocol (MCP) server that gives any AI agent instant access to Polymarket prediction-market data — search markets, check probabilities, analyse liquidity, track price history, and more.
Built with FastMCP in pure Python. Part of the Polycool ecosystem.
Why does this exist?
AI agents need real-time data feeds to be useful. Prediction markets are one of the best sources of crowd-sourced probability estimates on world events.
This project bridges the gap:
- No trading. Read-only market data.
- No wallets. No blockchain signing, no private keys.
- No complexity. Seven tools, zero configuration.
Just plug it into Claude Desktop, Cursor, or any MCP-compatible client and start asking questions about the future.
Tools
| Tool | Description |
|---|---|
search_markets |
Full-text search across all markets (e.g. "Bitcoin", "NBA", "election") |
trending_markets |
Top markets ranked by 24-hour volume |
new_markets |
Most recently launched markets |
markets_closing_soon |
Markets resolving within N hours |
market_summary |
Detailed probability, volume, liquidity, spread & metadata |
market_orderbook |
Live orderbook with bids, asks, spread & last trade price |
market_price_history |
Historical price data with min, max, and % change over any time window |
Quick Install
Prerequisites
Install uv (fast Python package manager):
curl -LsSf https://astral.sh/uv/install.sh | sh
Cursor
Add to your ~/.cursor/mcp.json (global) or .cursor/mcp.json (per-project):
macOS / Linux:
{
"mcpServers": {
"polymarket": {
"command": "/Users/YOUR_USERNAME/.local/bin/uvx",
"args": ["--python", "3.11", "polymarket-mcp"]
}
}
}
Windows:
{
"mcpServers": {
"polymarket": {
"command": "uvx",
"args": ["--python", "3.11", "polymarket-mcp"]
}
}
}
Note: On macOS/Linux, Cursor may not find
uvxin your PATH. Use the full path instead — runwhich uvxin your terminal to find it.
Restart Cursor. The Polymarket tools appear in the tool list.
Claude Desktop
Add to your config file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"polymarket": {
"command": "uvx",
"args": ["--python", "3.11", "polymarket-mcp"]
}
}
}
pip
pip install polymarket-mcp
polymarket-mcp
Example Prompts
Once connected, try asking your AI agent:
"Show me the top 10 trending markets on Polymarket"
"Find all markets about Bitcoin"
"Which markets resolve in the next 24 hours?"
"Give me a detailed summary of this market"
"Show me the price history for this market over the last week"
"What does the orderbook look like for this market?"
Example Output
{
"market_id": "21742",
"question": "Will Bitcoin exceed $100,000 by June 2026?",
"probability": 0.72,
"volume_24h": 245000,
"volume_total": 8900000,
"liquidity": 620000,
"best_bid": 0.71,
"best_ask": 0.73,
"spread": 0.02,
"category": "Crypto",
"end_date": "2026-06-30T00:00:00Z",
"active": true
}
APIs Used
| API | Purpose |
|---|---|
| Polymarket Gamma API | Market data, events, full-text search |
| Polymarket CLOB API | Orderbook, price history, last trade price |
Both APIs are public and free. No API key required.
Built by Polycool
This MCP server is built and maintained by the Polycool team.
Polycool lets you track and copy top Polymarket traders — insiders and smart wallets — in one tap.
- polycoolapp.com — Web app
- @polycoolapp_bot — Telegram bot for instant alerts and copy-trading
- Backed by the Polymarket Builder Program
License
MIT
polymarket api, polymarket mcp server, prediction market api, polymarket data, polymarket analytics, polymarket python, polymarket ai agent, model context protocol, polycool, polymarket copy trading, polymarket telegram bot
Metadata
Release files for polymarket-mcp 0.1.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| polymarket_mcp-0.1.3.tar.gz | 9.6 kB | Without provenance | Details for polymarket_mcp-0.1.3.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| polymarket_mcp-0.1.3-py3-none-any.whl | Python 3 | none | any | Details for polymarket_mcp-0.1.3-py3-none-any.whl |
Total release size: 19.6 kB
Release files / polymarket_mcp-0.1.3.tar.gz
| Download URL | polymarket_mcp-0.1.3.tar.gz |
|---|---|
| Size | 9.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a89974425c168e8baf5acf2fb37f3cc087cbb59829d66721d728d6545f8c6047
|
|
BLAKE2b-256 checksum How to use checksums |
0ecd8c53d8b332e84019742f2afd2552e35b434f9f3993cb088730cea8e9bc3d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.10 {"installer":{"name":"uv","version":"0.10.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / polymarket_mcp-0.1.3-py3-none-any.whl
| Download URL | polymarket_mcp-0.1.3-py3-none-any.whl |
|---|---|
| Size | 10.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2c78ddd39f4da4345430788dc016fc8ceb8ea20283ea6cc1ce9b3ca1dd9ab61d
|
|
BLAKE2b-256 checksum How to use checksums |
fc7562aa3549fe0679fe2859a10dda09f1a04611f8f3281542b984e7d13c90cd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.10 {"installer":{"name":"uv","version":"0.10.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for polymarket-mcp 0.1.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.