berlinbra/polymarket-mcp

A Model Context Protocol (MCP) server that provides access to prediction market data through the PolyMarket API. This server implements a standardized interface for retrieving market information, prices, and historical data from prediction markets.
## Features
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
## Installation
#### Installing via Smithery
To install PolyMarket Predictions for Claude Desktop automatically via Smithery:
bash
npx -y @smithery/cli install polymarketmcp --client claude
#### Claude Desktop
On MacOS: ~/Library/Application\ Support/Claude/claudedesktopconfig.json
On Windows: %APPDATA%/Claude/claudedesktopconfig.json
Development/Unpublished Servers Configuration
json
"mcpServers": {
"polymarket-mcp": {
"command": "uv",
"args": [
"--directory",
"/Users/{INSERTUSER}/YOUR/PATH/TO/polymarket-mcp",
"run",
"polymarket-mcp" //or src/polymarketmcp/server.py
],
"env": {
"KEY": " ",
"FUNDER": " "
### Running Locally
1. Clone the repository and install dependencies:
#### Install Libraries
uv pip install -e .
### Running
After connecting Claude client with the MCP tool via json file and installing the packages, Claude should see the server's mcp tools:
You can run the sever yourself via:
In polymarket-mcp repo:
uv run src/polymarketmcp/server.py
if you want to run the server inspector along with the server:
npx @modelcontextprotocol/inspector uv --directory C:\\Users\\{INSERTUSER}\\YOUR\\PATH\\TO\\polymarket-mcp run src/polymarketmcp/server.py
2. Create a .env file with your PolyMarket API key:
Key=yourapikeyhere
Funder=poly market wallet address
After connecting Claude client with the MCP tool via json file, run the server:
In alpha-vantage-mcp repo: uv run src/polymarketmcp/server.py
## Available Tools
The server implements four tools:
get-market-info: Get detailed information about a specific prediction market
list-markets: List available prediction markets with filtering options
get-market-prices: Get current prices and trading information
get-market-history: Get historical price and volume data
### get-market-info
Input Schema:
json
"marketid": {
"type": "string",
"description": "Market ID or slug"
Example Response:
Title: Example Market
Category: Politics
Status: Open
Resolution Date: 2024-12-31
Volume: $1,234,567.89
Liquidity: $98,765.43
Description: This is an example prediction market...
### list-markets
Input Schema:
json
"status": {
"type": "string",
"description": "Filter by market status",
"enum": ["open", "closed", "resolved"]
},
"limit": {
"type": "integer",
"description": "Number of markets to return",
"default": 10,
"minimum": 1,
"maximum": 100
},
"offset": {
"type": "integer",
"description": "Number of markets to skip (for pagination)",