# polymarket-mcp

Connects AI coding agents to Polymarket prediction data without setup or API keys. Tracks volume leaders and live smart-money wallet trades.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 314 installs
- Author: istarley2000
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/istarley2000/polymarket-mcp
- Updated: 2026-06-14
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/polymarket-mcp

## What it 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.

## Requirements
- Remote server: `https://polymarket-mcp--istarley2000.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http polymarket-mcp https://polymarket-mcp--istarley2000.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add polymarket-mcp --url https://polymarket-mcp--istarley2000.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "polymarket-mcp": {
            "url": "https://polymarket-mcp--istarley2000.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "polymarket-mcp": {
            "type": "http",
            "url": "https://polymarket-mcp--istarley2000.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http polymarket-mcp https://polymarket-mcp--istarley2000.run.tools
```

## When to use it
- 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
- 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.

## Similar
- [Polymarket](https://affpapa.org/en/nevibecode/mcp/polymarket.md) — MCP server · 10102 installs
- [polymarket-api](https://affpapa.org/en/nevibecode/skills/polymarket-api.md) — skill · 973 installs
- [polymarket-strategy-advisor](https://affpapa.org/en/nevibecode/skills/polymarket-strategy-advisor.md) — skill · 237 installs
- [Polymarket Data by PolymarketScan](https://affpapa.org/en/nevibecode/mcp/polymarket-data-by-polymarketscan.md) — MCP server · 39483 installs
- [monitor-polymarket](https://affpapa.org/en/nevibecode/skills/monitor-polymarket.md) — skill · ★ 797 repo stars
- [Vectorial Data Terminal: Hyperliquid, Polymarket & yield for AI agents](https://affpapa.org/en/nevibecode/mcp/vectorial-data-terminal-hyperliquid-polymarket-yield-for-ai-agents.md) — MCP server

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
