B
berlinbra/polymarket-mcp
MCP Server for PolyMarket API
View on GitHub ↗Link checked 2026-11-12 · HTTP 200 · opens the vendor's own site
Install & config
Client config (built from the install command this repo gives)
{
"mcpServers": {
"berlinbra-polymarket-mcp": {
"command": "npx",
"args": ["-y", "@smithery/cli"]
}
}
}Parsed from the README we fetched on 2026-11-06; we have not executed it.
command/args come from the install command the repository states. When it is ambiguous, the project README wins.
VS Code (.vscode/mcp.json - the key is servers)
{
"servers": {
"berlinbra-polymarket-mcp": {
"command": "npx",
"args": ["-y", "@smithery/cli"]
}
}
}Same server, but VS Code keeps it under <code>servers</code>.
Claude Code (command line)
claude mcp add --transport stdio berlinbra-polymarket-mcp -- npx -y @smithery/cli
Claude Code does not read a config file; add the server with this command.
Key names differ by client: Clients & CLI
- Source
- collected from the abordage/awesome-mcp list · type: MCP server
- Harvest history
- first seen 2026-11-05 · last seen 2026-11-14 · seen 10× · listed by 10 sources
- Score
- score 1,003 · 10 sources · mcp
- Install
npx -y @smithery/cli
FAQ (answers come from our records)
How do I install it?
The repository provides this install command:
npx -y @smithery/cli. It comes from the repository itself; we cannot guarantee it runs as-is in your client.Who is it for?
We filed it under these tags: MCP 服务. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
first catalogued 2026-11-05；last seen 2026-11-14。There is no official certification or quality rating here — we record sources and dates only.
# PolyMarket MCP Server
以下摘录自该仓库的 README（片段） · 在 GitHub 读完整 README →
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)",
## 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)",
Listed badge (optional)
Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.
[](https://anclum.com/en/s/berlinbra-polymarket-mcp/)
- Source
- awesome · https://github.com/berlinbra/polymarket-mcp
- Browse by field
- MCP servers
- Listed by
- 10 independent sources
- added
- today
More like this
Filed under
Every tag opens the full list for that filter. Counts are the live catalogue figures.