get-market-infoLABSCO SUMMARY
What a market thinks will happen, with the history behind the number.
Current price plus the history is the pairing that matters: today's probability means something quite different if it was far lower last week. The tools read markets; placing or settling a position is not part of the set.
What it is
A server over the PolyMarket API for market listings, current prices and historical price and volume data.
What you get
- The markets available on PolyMarket (list-markets)
- One market in detail, with category, description and resolution date (get-market-info)
- Current prices and the probabilities they imply (get-market-prices)
- Price and volume history over 1d, 7d, 30d or the market's whole life (get-market-history)
- Rate-limit handling and consistent formatting, so responses arrive usable
Requirements
The private key and funder address exported from your Polymarket account, passed as KEY and FUNDER; the server derives its API credentials from them. Runs with uv from a clone of the repository.
Setup effort
Build from source
USE CASES
01
Finding out what the market thinks about an event
Find the market, then read the current price and implied probability.
02
Checking how a probability has moved
Pull the history over 7d or 30d instead of judging from today's number alone.
03
Reading the fine print before trusting the odds
Read the market description and resolution date, which decide what the price actually means.
04
Comparing several markets on one topic
List the related markets and read their prices side by side.
4 tools
Listed in project docs. Your client may show a different list.
list-marketsget-market-pricesget-market-historyBEFORE YOU INSTALL
What to know first
Tools you get
4 tools named in the project's documentation.
Requires
- Python 3.10+
- uv
- KEY in your environment
- FUNDER in your environment
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
git clone https://github.com/berlinbra/polymarket-mcp.gitMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"polymarket-mcp": {
"command": "uv",
"args": [
"--directory",
"<YOUR_PATH_TO_POLYMARKET_MCP>",
"run",
"src/polymarket_mcp/server.py"
],
"env": {
"KEY": "<YOUR_POLY_MARKET_API_KEY>",
"FUNDER": "<YOUR_FUNDER>"
}
}
}
}<YOUR_PATH_TO_POLYMARKET_MCP> is the folder you cloned. Uv installs the dependencies on first run. KEY is the private key exported from the Polymarket UI and FUNDER is your Polymarket funder (wallet) address — the server uses them to derive its API credentials.
