polymarket-mcp

MCP.Pizza Chef: berlinbra

Four read-only tools promise market listings, details, current prices, and history. Only the listing one really delivers: the history tool never fetches any history and silently ignores the time period you choose, the price tool reads a field the service does not send back, and the status filter matches nothing. More seriously, the credential it asks for is not an ordinary key but your Polymarket wallet's private key, which you would be leaving in a plain settings file. The code has not changed since June 2025.

Unmaintained · no code changes since June 2025

Data

Web/Research

Use This MCP server To

Browse which prediction markets are open right now See the trading volume on a market I care about Look up the identifier for a market I want to research Check whether a particular market has closed yet Skim a page of markets and their end dates

README

PolyMarket MCP Server

A Model Context Protocol (MCP) server that provides access to prediction market data through the PolyMarket API. This server implements a standardized interface for retrieving market information, prices, and historical data from prediction markets.

Features

Real-time prediction market data with current prices and probabilities
Detailed market information including categories, resolution dates, and descriptions
Historical price and volume data with customizable timeframes (1d, 7d, 30d, all)
Built-in error handling and rate limit management
Clean data formatting for easy consumption

Installation

Installing via Smithery

To install PolyMarket Predictions for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install polymarket_mcp --client claude

Claude Desktop

On MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json

Development/Unpublished Servers Configuration

polymarket-mcp FAQ

What credential does it need?

Not a normal key, despite how the instructions read. It wants the private key for your Polymarket wallet plus that wallet's address, and you would be storing the private key as plain text in a settings file. That key is what controls the money in the wallet, so treat this as a genuine risk rather than a formality.

Can it place bets or spend my money?

Not as written. None of the four tools buy, sell, or move anything, and no trading action is offered to the assistant. The concern is the key itself: anything that could read that file would hold the keys to the wallet.

Does the historical data tool work?

No. It asks for the same basic market record as the details tool and then looks for history inside it, which is never there, so you get nothing back. The time period you choose is read into the code and then never used.

Can I use this to check the current odds on a market?

Not reliably. The price tool looks for a field the service does not return, so the price usually comes back as unavailable. Listing markets and reading their volumes is the part that actually works.

Is it still being maintained?

No. There have been no code changes since June 2025, well over a year ago, and the known problems above are still present.

How hard is setup?

This one is for confident users. You clone the code, install it with a Python tool, and point your app at a folder on your machine; there is no simple one-line install.

Which apps does it work in?

Claude Desktop is the documented target, and there is a Smithery installer. Any app where you can point at a local command would also work.

Does it need a paid Polymarket account?

There is no subscription, but the wallet it wants the key for is a real funded Polymarket wallet, so it assumes you already have one set up.