Polymarket MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Polymarket MCP Server search for election markets"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Polymarket MCP Server
MCP server for Polymarket prediction markets — powered by the official polymarket-us TypeScript SDK.
Features
6 MCP tools for reading market data, searching, and analyzing bets
Public data — no API key needed for reading markets
Trading ready — supports authenticated endpoints with API key
Dual mode — runs as stdio MCP (DuckHive/OpenClaw) or HTTP server
Related MCP server: Polymarket MCP Server
Installation
cd polymarket-mcp
npm installDuckHive / OpenClaw Setup
Add to ~/.duckhive.json:
{
"mcpServers": {
"polymarket": {
"command": "node",
"args": ["/path/to/polymarket-mcp.mjs"]
}
}
}For trading (optional), add your API key:
{
"mcpServers": {
"polymarket": {
"command": "node",
"args": ["/path/to/polymarket-mcp.mjs"],
"env": {
"POLYMARKET_KEY_ID": "your_key_id",
"POLYMARKET_SECRET_KEY": "your_secret_key"
}
}
}
}Get your API key at: https://app.polymarket.com/api-keys
Tools
Tool | Description |
| Search markets by keyword |
| Full market details by slug |
| Trending events by volume |
| Current odds + best bid/ask |
| Odds, profit calc, vig, value rating |
| Browse events by category |
HTTP Mode (testing)
node polymarket-mcp.mjs --http
curl http://localhost:3457/healthKnown 2026 Midterm Slugs
Market | Slug |
Senate GOP win |
|
Senate Democrat win |
|
House Democrat win |
|
House GOP win |
|
Docs
Available Tools
6 toolsget_polymarket_bet_analysisA
Full bet analysis: current odds, implied probability, potential profit on a $100 bet, vig estimate, and value assessment.
Inputs: slug (required), betSize.
get_polymarket_eventsA
List Polymarket events (groupings of related markets). Good for browsing by category like politics, sports, crypto.
Inputs: category, limit.
get_polymarket_marketA
Get full details for a specific Polymarket market by slug. Includes current odds, outcomes, volume, liquidity, and order book.
Inputs: slug (required), includeBook.
get_polymarket_priceA
Get current odds for a specific market by slug. Shows all outcomes with implied probability.
Inputs: slug (required).
get_polymarket_trendingA
Get trending Polymarket events ordered by volume. Good for discovering popular markets.
Inputs: limit.
search_polymarketA
Search Polymarket markets by keyword. Returns matching events with their markets, odds, and volume. Use this to find slugs for other tools.
Inputs: query (required), limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool has a clearly distinct function: analysis, event listing, market details, price, trending, and search. No overlapping purposes.
All tools use a consistent 'get_' or 'search_' prefix followed by the domain name 'polymarket' with underscore-separated words, making them predictable.
Six tools is optimal for a prediction market server, covering browsing and analysis without being too sparse or overly numerous.
The tools cover key operations: listing, searching, getting details, pricing, trending, and analysis. However, actions like placing bets or managing accounts are absent, which might limit full workflow integration.
Maintenance
Related MCP Connectors
Read-only MCP server for live Polymarket, Kalshi, Limitless odds; Manifold sentiment.
Your agent needs the crowd's number — live odds on elections, policy, macro prints and sport, from the venues where people put money behind the opinion. **What you can ask for** • "What are the current odds on this event?" • "List the open markets on this topic across both venues." • "Show recent trades and how the price moved." • "What is the implied probability now versus a week ago?" **How to use it** Point any MCP client at https://mcp.aisa.one/prediction-market-data/mcp and sign in with OAuth — there is no key to create or paste. 5 tools: Kalshi markets and trades, Polymarket markets, events and activity. **Why this rather than the source** Both venues in one shape, so the same question can be priced twice. **It is also a door to the rest** The same login reaches 26 sources and 580+ operations. Read the odds here, then ask the same agent for the market data or the news behind them — without adding a second server. **What it costs** Finding and inspecting an operation is free. Running one is billed per call at API prices, with no seat and no monthly minimum, and every call takes max_price_usd so an agent cannot overspend by accident. **Where else it reaches** https://mcp.aisa.one/finance/mcp for equities, crypto and prediction markets in one place.
Historical tick, order book and settlement data for Polymarket and Predict.fun crypto up/down markets, plus smart-money lists and backtest quotes, over a read-only MCP server.
Polymarket & Kalshi live prediction market odds aggregator and cross-venue arbitrage scanner MCP.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceMCP server that exposes Polymarket prediction markets via CLI wrapper. Enables AI agents to discover markets, check prices, and place trades programmatically.-
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables seamless integration with Polymarket, providing tools to search markets, fetch events, analyze leaderboards, query user activity, and more via MCP-compatible clients like Claude.44 npmMIT
- AlicenseNot gradedqualityCmaintenanceMCP server for querying and optionally trading across prediction markets (Polymarket, Kalshi, Limitless, Manifold) through a unified API.31MIT
- AlicenseCqualityDmaintenanceMCP server exposing 47 Polymarket API tools for AI assistants. Covers the full Gamma, CLOB, and Data APIs plus a fluent MarketBuilder for multi-source queries.4744 npm2MIT