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).
PolyMarket MCP Server
@berlinbra
Basic information
About PolyMarket MCP Server
MCP Server for PolyMarket API
PolyMarket MCP Server 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"
]
}
}
}PolyMarket MCP Server 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
Frequently asked questions
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.
More Other MCP servers
Klarix Intelligence Engine
KlarixB2B competitive intelligence, live sales battlecards, 5-axis ICP prospect fit scoring, and tech stack teardowns over MCP and REST with cited public-web evidence.
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!
39.5K
MCP Toolbox for Databases
googleapisMCP Toolbox for Databases is an open source MCP server for databases.
15.9K
YOUB
Connect your AI assistant to your own YOUB endurance training account. Read recorded activities with full analysis, planned sessions, race goals, wellness (HRV, sleep, resting HR) and your athletic profile. Create or mov
Activepieces
activepiecesAI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
23.2K
Comments