# polymarket-toolkit

Supplies AI agents with read-only Polymarket data, including wallet PnL and market volume metrics. Works without private keys or trading credentials.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 200
- Author: runesleo
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/runesleo/polymarket-toolkit
- Updated: 2026-09-09
- HTML: https://affpapa.org/en/nevibecode/mcp/polymarket-toolkit

## What it does

The server exposes public Polymarket endpoints to coding assistants. Agents can inspect wallet histories and measure maker versus taker fill distributions. Trading execution and transaction signing are completely excluded.

Agent setups run the integration via `npx -y polymarket-toolkit-mcp`. Repository CLI tools depend on Node 22 or newer because of type-stripping flags. The audit script fails immediately if Python lacks the `httpx` package.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add polymarket-toolkit -- npx -y polymarket-toolkit-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add polymarket-toolkit -- npx -y polymarket-toolkit-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "polymarket-toolkit": {
            "command": "npx",
            "args": [
                "-y",
                "polymarket-toolkit-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "polymarket-toolkit": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "polymarket-toolkit-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add polymarket-toolkit npx -y polymarket-toolkit-mcp
```

## When to use it
- Inspect lifetime wallet PnL and active positions on Polymarket
- Calculate Brier scores to verify prediction accuracy
- Scan active prediction markets by 24-hour volume
- Evaluate trader execution style by checking maker and taker fills

## Example prompts
- Check the lifetime PnL and open bets for address 0x63ce342161250d705dc0b16df89036c8e5f9ba9a
- List active Polymarket events sorted by highest 24-hour volume
- Compute the Brier accuracy score for settled markets on this wallet

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [CCXT](https://affpapa.org/en/nevibecode/mcp/ccxt.md) — MCP server · ★ 44583
- [Finance Toolkit](https://affpapa.org/en/nevibecode/mcp/finance-toolkit.md) — MCP server · ★ 5458
- [EdgarTools](https://affpapa.org/en/nevibecode/mcp/edgartools.md) — MCP server · ★ 2814
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2188
- [AutoTS](https://affpapa.org/en/nevibecode/mcp/autots.md) — MCP server · ★ 1434

---
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