MCP 服务器

Polymarket MCP Tool

A Model Context Protocol server that enables interaction with Polymarket prediction markets through Claude Desktop.

Tools

prediction_markets_trending_topics

Use when analysing a user’s portfolio and you need external sentiment from prediction markets. Retrieves today’s trending Polymarket topics (ordered by 24-hour volume). Pass any slug from this list to `prediction_markets_markets_by_topic` to pull the individual markets for that theme. Returns ------- str A JSON array (string) of topic slugs ordered by 24-hour volume, e.g. '["Trump-Presidency", "Oil-Prices", "Iran"]'.

prediction_markets_markets_by_topic

Call after you have a Polymarket topic slug (from the user or `prediction_markets_trending_topics`) and need the top markets under it. Parameters ---------- topic_slug : str Identifier such as "trump-presidency". limit : int, default 10 Number of markets to return, ranked by 24-hour volume (desc). Returns ------- str JSON array of objects with the schema: [ { "title": "Trump to win 2024?", "volume": 123456.78, "outcomes": [ {"option": "Yes", "probability": 0.42}, {"option": "No", "probability": 0.58} ] }, … ] Parse with `json.loads`.

search_prediction_markets

Search prediction markets by any term. Parameters ---------- search_term : str Identifier such as "argentina". Returns ------- str JSON array of objects with the schema: [ { "title": "Trump to win 2024?", "volume": 123456.78, "outcomes": [ {"option": "Yes", "probability": 0.42}, {"option": "No", "probability": 0.58} ] }, … ] Parse with `json.loads`.

README

Polymarket MCP Tool

A Model Context Protocol (MCP) tool for interacting with Polymarket through Claude Desktop.

Prerequisites

Claude Desktop App for Mac
Python 3.8+

Installation

Clone this repository:

git clone https://github.com/fernandezpablo85/polymarket-mcp.git
cd polymarket-mcp

Install uv if you haven't already:

curl -LsSf https://astral.sh/uv/install.sh | sh

Install dependencies:

uv sync

Configure Claude Desktop

Open Claude Desktop configuration directory:

open ~/Library/Application\ Support/Claude

Create or edit claude_desktop_config.json:

touch ~/Library/Application\ Support/Claude/claude_desktop_config.json

Add the following configuration:

{
  "mcpServers": {
    "polymarket": {
      "command": "/Users/YOUR_USERNAME/.local/bin/uv",
      "args": [
        "--directory",
        "/Users/YOUR_USERNAME/projects/polymarket-mcp",
        "run",
        "main.py"
      ]
    }
  }
}

Replace YOUR_USERNAME with your actual macOS username.

Usage

Invoke the tool via Claude Desktop.

Troubleshooting

If tools don't appear in Claude Desktop:
- Verify your claude_desktop_config.json is correct
- Restart Claude Desktop
- Check your Python path and dependencies
If authentication fails:
- Verify your .env file has correct credentials
- Check Polymarket API status