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
XcodeBuildMCP
cameroncookeA Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.
MCP Go 🚀
mark3labsA Go implementation of the Model Context Protocol (MCP), enabling seamless integration between LLM applications and external data sources and tools.
Sequential Thinking
modelcontextprotocolModel Context Protocol Servers
Codelf
unbugA search tool helps dev to solve the naming things problem.
Unity MCP ✨
justinpbarnettUnity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.
Comments