PolyMarket MCP Server
@berlinbra
About PolyMarket MCP Server
MCP Server for PolyMarket API
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"polymarket-mcp": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"polymarket_mcp",
"--client",
"claude"
]
}
}
}Tools
4Get detailed information about a specific prediction market
List available prediction markets with filtering options
Get current prices and trading information
Get historical price and volume data
Overview
What is PolyMarket MCP Server?
PolyMarket MCP Server is a Model Context Protocol (MCP) server that provides access to prediction market data through the PolyMarket API. It implements a standardized interface for retrieving market information, prices, and historical data, intended for use with MCP-compatible AI clients.
How to use PolyMarket MCP Server?
Install via Smithery (npx -y @smithery/cli install polymarket_mcp --client claude) or manually by cloning the repository, installing dependencies with uv pip install -e ., and creating a .env file with your PolyMarket API key and wallet address. Then add the server configuration to your MCP client JSON and run uv run src/polymarket_mcp/server.py.
Key features of PolyMarket MCP Server
- Real-time prediction market data with current prices and probabilities
- Detailed market information including categories, resolution dates, and descriptions
- Historical price and volume data with customizable timeframes (1d, 7d, 30d, all)
- Built-in error handling and rate limit management
- Clean data formatting for easy consumption
- Filterable market listing with pagination (up to 100 markets)
Use cases of PolyMarket MCP Server
- Query detailed information about a specific prediction market
- List available prediction markets with optional status filtering
- Retrieve current prices and trading information for a market
- Fetch historical price and volume data for trend analysis
FAQ from PolyMarket MCP Server
What are the dependencies and runtime requirements?
Python 3.9 or higher, plus the packages httpx (>=0.24.0), mcp-core, and python-dotenv (>=1.0.0).
How does authentication work?
You must provide a PolyMarket API key and a wallet address (Funder) via a .env file. Missing or invalid credentials result in 403 errors.
What transport does the server use?
The server runs locally via the command line and communicates over standard input/output (stdio), as configured in the MCP client JSON.
How does the server handle rate limits and errors?
It includes built-in handling for rate limiting (429), invalid API keys (403), invalid market IDs (404), network issues, and timeouts (30-second limit). Errors are returned in a clear, human-readable format.
Does the server store any data locally?
No. All data is fetched live from the PolyMarket API. The server does not persist any data on the local machine.
Frequently asked questions
What are the dependencies and runtime requirements?
Python 3.9 or higher, plus the packages httpx (>=0.24.0), mcp-core, and python-dotenv (>=1.0.0).
How does authentication work?
You must provide a PolyMarket API key and a wallet address (Funder) via a `.env` file. Missing or invalid credentials result in 403 errors.
What transport does the server use?
The server runs locally via the command line and communicates over standard input/output (stdio), as configured in the MCP client JSON.
How does the server handle rate limits and errors?
It includes built-in handling for rate limiting (429), invalid API keys (403), invalid market IDs (404), network issues, and timeouts (30-second limit). Errors are returned in a clear, human-readable format.
Does the server store any data locally?
No. All data is fetched live from the PolyMarket API. The server does not persist any data on the local machine.
Basic information
More Other MCP servers
Mobile Mcp
mobile-nextModel Context Protocol Server for Mobile Automation and Scraping (iOS, Android, Emulators, Simulators and Real Devices)
XcodeBuildMCP
cameroncookeA Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.
Reactive Resume
amruthpillaiA one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!
Production-ready MCP integrations for AI applications
Klavis-AIKlavis AI: MCP integration platforms that let AI agents use tools reliably at any scale
MCP Go 🚀
mark3labsA Go implementation of the Model Context Protocol (MCP), enabling seamless integration between LLM applications and external data sources and tools.
Comments