kukapay/polymarket-predictions-mcp

Polymarket Predictions MCP

An MCP server that delivers real-time market odds from Polymarket, enabling AI agents and analysts to access, compare, and act on decentralized prediction data.

Features

• Event Retrieval: Fetch Polymarket events with details (title, description, endDate, volume) and associated markets in a tabulated format.
• Market Retrieval: Retrieve markets with key fields (question, zipped outcomes and outcomePrices, endDate, volume, closed) in a table.
• Event Search: Search for events using Polymarket's /public-search endpoint with comprehensive query parameters.
• Prompt Support: Includes a prompt template for analyzing specific markets.
• Formatted Outputs: Uses tabulate for clean, readable table outputs and handles JSON parsing for outcomes and prices.

Installation

Prerequisites

• Python 3.10 or higher
• uv (recommended) or pip for dependency management

Setup

1. Clone the Repository:

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

2. Install Dependencies: Using uv:

   uv sync
   

   Or using pip:

   pip install mcp[cli] httpx tabulate
   

3. Install to Claude Desktop:

   Install the server as a Claude Desktop application:

   uv run mcp install main.py --name "Polymarket Predictions"
   

   Configuration file as a reference:

   {
      "mcpServers": {
          "Polymarket Predictions": {
              "command": "uv",
              "args": [ "--directory", "/path/to/polymarket-predictions-mcp", "run", "main.py" ]
          }
      }
   }
   

   Replace /path/to/polymarket-predictions-mcp with your actual installation path.