polymarket-mcp
Provides access to Polymarket prediction market data, including top markets, order books, and token resolution, with on-chain verification via the Polygon blockchain.
Click on "Install 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-mcpshow me the top active Polymarket 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
Clean, NegRisk-resolved Polymarket market & order-book data as an MCP server. No API key, no database — stateless wrappers over the public Gamma and CLOB APIs, with the messy parts (keyset pagination, NegRisk flags, token→outcome resolution, book parsing) already handled for you.
Point any MCP client (Claude Desktop, Cowork, Cursor, …) at it and your agent can query prediction-market data directly.
Tools
Tool | What it does |
| Top active markets by liquidity or 24h volume. Returns question, conditionId, outcome→tokenId mapping, negRisk flag, event, liquidity, volume, best bid/ask, spread. Filters: |
| Live CLOB order book(s) for one or more outcome token ids. Sorted bids/asks + best bid/ask, spread, midpoint. |
| Resolve a |
| On-chain-verified resolution: derives |
Related MCP server: Polymarket MCP Server
Install & run
Requires Node 18+ (uses the built-in fetch).
npm install
npm run buildAdd to your MCP client config (e.g. Claude Desktop claude_desktop_config.json):
{
"mcpServers": {
"polymarket": { "command": "node", "args": ["/absolute/path/to/polymarket-mcp/dist/server.js"] }
}
}Then ask your agent things like "what are the most active Polymarket markets right now?" or "get the order book for this token id".
Try it without a client
npm run build && npm run smoke # drives the server over stdio against live APIsTests
npm test # unit tests for the ABI encoders — pure, no networkThe encoder tests are deliberately network-free so they run anywhere. The API
and on-chain paths are verified against live endpoints by hand (see npm run smoke), since CI has no route to Polymarket or a Polygon RPC.
Config (all optional)
Env | Default |
|
|
|
|
|
|
| (unset) — required only for |
Picking a Polygon RPC
The tool only needs eth_blockNumber and eth_call, so a free keyless endpoint
is enough. Verified working without an API key:
export POLYGON_RPC_URL="https://polygon-bor-rpc.publicnode.com"https://polygon.drpc.org and https://1rpc.io/matic also answer keyless.
Note that https://polygon-rpc.com and https://rpc.ankr.com/polygon now
return 401 / Unauthorized and require an account.
Passing the optional block argument reads historical state, which needs an
archive node — most free endpoints reject it (publicnode returns "Archive
requests require a personal token"). The tool surfaces that as an error rather
than pretending the token is unregistered. Omit block to read latest.
Notes
Read-only. No trading, no orders, no keys. It reads public data.
Every fetch has a hard timeout + backstop so a stalled upstream can't hang the server.
This is a data-access tool, not trading advice. Prices and books are live public data; verify before acting on them.
License
MIT
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Alicense-qualityFmaintenanceEnables access to Polymarket's prediction markets for analyzing market probabilities, trading activity, and event outcomes across politics, sports, crypto, and other categories through natural language queries.Last updated4110MIT
- Alicense-qualityDmaintenanceEnables AI assistants to query Polymarket prediction markets, accessing real-time odds, market data, price history, order books, and trending markets across categories like politics, crypto, and sports through natural language.Last updated415MIT
- AlicenseBqualityDmaintenanceEnables comprehensive read access to Polymarket prediction market data, including live prices, order books, and market statistics. It allows AI assistants to analyze events, search markets, and monitor real-time signals without requiring API keys or authentication.Last updated221MIT
- Flicense-qualityCmaintenanceEnables interaction with Polymarket prediction markets through read-only access to market data, events, orderbooks, and user positions, plus authenticated trading capabilities for creating and managing orders.Last updated1
Related MCP Connectors
Polymarket MCP — prediction-market data via Gamma + CLOB public APIs.
Classify Polymarket wallets as human or bot, score their trading edge, read open positions.
Kalshi MCP — US-regulated prediction-market data (no auth on public reads).
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/simonlokc/polymarket-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server