polymarket-mcp
MCP Server for PolyMarket API
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/berlinbra--polymarket-mcp)HTML
<a href="/listings/berlinbra--polymarket-mcp"><img src="/api/listings/berlinbra--polymarket-mcp/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Installing via Smithery
To install PolyMarket Predictions for Claude Desktop automatically via [Smithery](https://smithery.ai/server/polymarket_mcp):
npx -y @smithery/cli install polymarket_mcp --client claude
Claude Desktop
- On MacOS: `~/Library/Application\ Support/Claude/claude_desktop_config.json` - On Windows: `%APPDATA%/Claude/claude_desktop_config.json`
<summary>Development/Unpublished Servers Configuration</summary>
"mcpServers": {
"polymarket-mcp": {
"command": "uv",
"args": [
"--directory",
"/Users/{INSERT_USER}/YOUR/PATH/TO/polymarket-mcp",
"run",
"polymarket-mcp" //or src/polymarket_mcp/server.py
],
"env": {
"KEY": "<insert poly market api key>",
"FUNDER": "<insert polymarket wallet address>"
}
}
}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/polymarket_mcp/server.py
*if you want to run the server inspector along with the server:
npx @modelcontextprotocol/inspector uv --directory C:\\Users\\{INSERT_USER}\\YOUR\\PATH\\TO\\polymarket-mcp run src/polymarket_mcp/server.py2. Create a `.env` file with your PolyMarket API key:
Key=your_api_key_here 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/polymarket_mcp/server.py`
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 245 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # PolyMarket MCP Server
- [](https://smithery.ai/server/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.
- <a href="https://glama.ai/mcp/servers/c255m147fd">
- <img width="380" height="200" src="https://glama.ai/mcp/servers/c255m147fd/badge" alt="PolyMarket Server MCP server" />
- </a>
- [](https://mseep.ai/app/berlinbra-polymarket-mcp)
- ## 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](https://smithery.ai/server/polymarket_mcp):
- ```bash
- npx -y @smithery/cli install polymarket_mcp --client claude
- ```
- #### Claude Desktop
- - On MacOS: `~/Library/Application\ Support/Claude/claude_desktop_config.json`
- - On Windows: `%APPDATA%/Claude/claude_desktop_config.json`
- <summary>Development/Unpublished Servers Configuration</summary>
- ```json
- "mcpServers": {
- "polymarket-mcp": {
- "command": "uv",
- "args": [
- "--directory",
- "/Users/{INSERT_USER}/YOUR/PATH/TO/polymarket-mcp",
- "run",
- "polymarket-mcp" //or src/polymarket_mcp/server.py
- ],
- "env": {
- "KEY": "<insert poly market api key>",
- "FUNDER": "<insert polymarket wallet address>"
- }
- }
- }
- ```
- ### 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/polymarket_mcp/server.py
- ```
- *if you want to run the server inspector along with the server:
- ```
- npx @modelcontextprotocol/inspector uv --directory C:\\Users\\{INSERT_USER}\\YOUR\\PATH\\TO\\polymarket-mcp run src/polymarket_mcp/server.py
- ```
- 2. Create a `.env` file with your PolyMarket API key:
- ```
- Key=your_api_key_here
- 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/polymarket_mcp/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
- {
- "market_id": {
- "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)",
- "default": 0,
- "minimum": 0
- }
- }
- ```
- **Example Response:**
- ```
- Available Markets:
- ID: market-123
- Title: US Presidential Election 2024
- Status: Open
- Volume: $1,234,567.89
- ---
- ID: market-124
- Title: Oscar Best Picture 2024
- Status: Open
- Volume: $234,567.89
- ---
- ```
- ### get-market-prices
- **Input Schema:**
- ```json
- {
- "market_id": {
- "type": "string",
- "description": "Market ID or slug"
- }
- }
- ```
- **Example Response:**
- ```
- Current Market Prices for US Presidential Election 2024
- Outcome: Democratic
- Price: $0.6500
- Probability: 65.0%
- ---
- Outcome: Republican
- Price: $0.3500
- Probability: 35.0%
- ---
- ```
- ### get-market-history
- **Input Schema:**
- ```json
- {
- "market_id": {
- "type": "string",
- "description": "Market ID or slug"
- },
- "timeframe": {
- "type": "string",
- "description": "Time period for historical data",
- "enum": ["1d", "7d", "30d", "all"],
- "default": "7d"
- }
- }
- ```
- **Example Response:**
- ```
- Historical Data for US Presidential Election 2024
- Time Period: 7d
- Time: 2024-01-20T12:00:00Z
- Price: $0.6500
- Volume: $123,456.78
- ---
- Time: 2024-01-19T12:00:00Z
- Price: $0.6300
- Volume: $98,765.43
- ---
- ```
- ## Error Handling
- The server includes comprehensive error handling for various scenarios:
- - Rate limiting (429 errors)
- - Invalid API keys (403 errors)
- - Invalid market IDs (404 errors)
- - Network connectivity issues
- - API timeout conditions (30-second timeout)
- - Malformed responses
- Error messages are returned in a clear, human-readable format.
- ## Prerequisites
- - Python 3.9 or higher
- - httpx>=0.24.0
- - mcp-core
- - python-dotenv>=1.0.0
- ## Contributing
- Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.