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.

Usage

The server exposes three tools and one prompt:

Tools

1. get_events: Fetches a list of Polymarket events with details and their associated markets.

   • Parameters:
     • limit: Number of events (default: 10)
     • offset: Pagination offset (default: 0)
     • order: Fields to order by (e.g., volume,markets.volume)
     • ascending: Sort order (default: False)
     • id: List of event IDs
     • slug: List of event slugs
     • tag_id: Tag ID filter
     • closed: Filter for closed events (default: False)
   • Output: Formatted string with event details (title, description, endDate, volume) and a table of markets (question, closed, volume, outcomes, outcomePrices).

   Example:

   • Prompt

     Show me the top 2 Polymarket events by volume, including only open events, with their market details.

   • Sample Output: