polymarket-mcp — Claude Code MCP server: what it does, how to install
Connects AI coding agents to Polymarket prediction data without setup or API keys. Tracks volume leaders and live smart-money wallet trades.
no license 314 installs updated 2026-06-14
claude mcp add --transport http polymarket-mcp https://polymarket-mcp--istarley2000.run.toolsWhat polymarket-mcp does
This server runs over HTTP using a remote endpoint, avoiding local storage and credential setup. It queries Polymarket public endpoints like Gamma and Data APIs alongside a hosted Oracle feed. Six tools cover 30-day top wallets by realized PnL, active markets ranked by volume, live trade histories for 0x addresses, market parameters by slug, and recent buy orders from profitable accounts.
For external verification, get_signed_snapshot exports a full JSON state signed with secp256k1 ECDSA. The signer address accompanies responses, so anyone can validate payload integrity directly against on-chain standards.
What it helps with
- track live buy orders from top-performing prediction wallets
- inspect volume and metadata for specific market slugs
- retrieve trade histories for any Polymarket 0x proxy address
- fetch ECDSA-signed snapshots for audit logs and verification
Example prompts for the agent
- Find the top 10 Polymarket traders ranked by 30-day profit.
- Show recent BUY trades from smart money in the past 20 minutes.
- Inspect market details for slug mlb-nyy-tor-2026-06-13.
How to install polymarket-mcp
Platform CLI: remote server
claude mcp add --transport http polymarket-mcp https://polymarket-mcp--istarley2000.run.toolsPlatform CLI: remote server
codex mcp add polymarket-mcp --url https://polymarket-mcp--istarley2000.run.toolsConfig file
{
"mcpServers": {
"polymarket-mcp": {
"url": "https://polymarket-mcp--istarley2000.run.tools"
}
}
}Config file
{
"servers": {
"polymarket-mcp": {
"type": "http",
"url": "https://polymarket-mcp--istarley2000.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http polymarket-mcp https://polymarket-mcp--istarley2000.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about polymarket-mcp
How to install polymarket-mcp in Claude Code?
Run claude mcp add --transport http polymarket-mcp https://polymarket-mcp--istarley2000.run.tools in your terminal.
Does polymarket-mcp require credentials or local databases?
No, the setup is completely stateless and consumes public Polymarket APIs plus a hosted signed Oracle without API keys.
How is oracle data verified in polymarket-mcp?
The get_signed_snapshot tool exposes a snapshot signed via ECDSA secp256k1 along with the signer address for verification.