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.

• 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.

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

1. Clone the Repository:

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

1. Install Dependencies:

Using uv:

   uv sync

Or using pip:

   pip install mcp[cli] httpx tabulate

1. 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