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,
Add this skill
npx mdskills install kukapay/polymarket-predictions-mcpWell-documented MCP server providing real-time Polymarket prediction data with clear examples
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.
title, description, endDate, volume) and associated markets in a tabulated format.question, zipped outcomes and outcomePrices, endDate, volume, closed) in a table./public-search endpoint with comprehensive query parameters.tabulate for clean, readable table outputs and handles JSON parsing for outcomes and prices.pip for dependency managementClone the Repository:
git clone https://github.com/kukapay/polymarket-predictions-mcp.git
cd polymarket-predictions-mcp
Install Dependencies:
Using uv:
uv sync
Or using pip:
pip install mcp[cli] httpx tabulate
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.
The server exposes three tools and one prompt:
get_events:
Fetches a list of Polymarket events with details and their associated markets.
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 IDsslug: List of event slugstag_id: Tag ID filterclosed: Filter for closed events (default: False)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:
## US Presidential Election 2024
Closed: False | End Date: 2024-11-05 | Volume: $1000000
Predict the outcome of the 2024 US Presidential Election...
Markets:
+--------------------------------------------------+----------+-----------+-------------------+-------------------+
| Question | Closed | Volume | Outcomes | Outcome Prices |
+==================================================+==========+===========+===================+===================+
| Who will win the 2024 US Presidential Election? | False | $500000 | Biden, Trump | 0.45, 0.55 |
+--------------------------------------------------+----------+-----------+-------------------+-------------------+
| Will Biden win the 2024 election? | False | $200000 | Yes, No | 0.40, 0.60 |
+--------------------------------------------------+----------+-----------+-------------------+-------------------+
## Super Bowl LVIII
Closed: True | End Date: 2024-02-11 | Volume: $500000
Predict outcomes related to Super Bowl LVIII...
Markets:
+--------------------------------------------------+----------+-----------+-------------------+-------------------+
| Question | Closed | Volume | Outcomes | Outcome Prices |
+==================================================+==========+===========+===================+===================+
| Who will win Super Bowl LVIII? | True | $300000 | Chiefs, 49ers | 0.60, 0.40 |
+--------------------------------------------------+----------+-----------+-------------------+-------------------+
get_markets:
Fetches a list of Polymarket markets with specified fields.
limit: Number of markets (default: 10)offset: Pagination offset (default: 0)order: Fields to order by (e.g., volume)ascending: Sort order (default: False)id: List of market IDsslug: List of market slugscondition_ids: List of condition IDsclosed: Filter for closed markets (default: False)question, options (zipped outcomes and outcomePrices), endDate, volume, and closed.Example:
Prompt:
List the top 2 Polymarket markets by trading volume, showing only open markets with their outcomes and prices.
Sample Output:
+--------------------------------------------------+-------------------------+---------------------+-----------+----------+
| Question | Options | End Date | Volume | Closed |
+==================================================+=========================+=====================+===========+==========+
| Who will win the 2024 US Presidential Election? | {"Biden": 0.45, "Trump": 0.55} | 2024-11-05 | $500000 | False |
+--------------------------------------------------+-------------------------+---------------------+-----------+----------+
| Will Bitcoin reach $100K by end of 2024? | {"Yes": 0.30, "No": 0.70} | 2024-12-31 | $200000 | False |
+--------------------------------------------------+-------------------------+---------------------+-----------+----------+
search_events:
Searches for events using the /public-search endpoint.
q: Search query (required)cache: Use cached resultsevents_status: Filter by event statuslimit_per_type: Results per type (default: 10)page: Page number for paginationevents_tag: List of event tagskeep_closed_markets: Number of closed marketssort: Field to sort byascending: Sort ordersearch_tags: Include tags in searchsearch_profiles: Include profiles in searchrecurrence: Filter by recurrence typeexclude_tag_id: List of tag IDs to excludeoptimized: Use optimized searchget_events.Example:
Prompt:
Search for Polymarket events about 'Bitcoin', filtering for active events with the 'crypto' tag, sorted by volume in ascending order.
Sample Output: (Similar format to get_events output, with Bitcoin-related events and markets)
analyze_market:
A prompt template for analyzing a specific market by slug, encouraging use of tools to fetch details and provide insights on probabilities, volume, and outcomes.
Example:
Prompt:
Analyze the Polymarket prediction market for 'us-presidential-election-2024' and provide insights on its probabilities, trading volume, and potential outcomes.
Command:
analyze_market(market_slug="us-presidential-election-2024")
This project is licensed under the MIT License. See the LICENSE file for details.
Install via CLI
npx mdskills install kukapay/polymarket-predictions-mcpPolymarket Predictions MCP is a free, open-source AI agent skill. 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,
Install Polymarket Predictions MCP with a single command:
npx mdskills install kukapay/polymarket-predictions-mcpThis downloads the skill files into your project and your AI agent picks them up automatically.
Polymarket Predictions MCP works with Claude Code, Claude Desktop, Cursor, Vscode Copilot, Windsurf, Continue Dev, Gemini Cli, Amp, Roo Code, Goose. Skills use the open SKILL.md format which is compatible with any AI coding agent that reads markdown instructions.