polymarket-toolkit — Claude Code MCP server: how to install
Supplies AI agents with read-only Polymarket data, including wallet PnL and market volume metrics. Works without private keys or trading credentials.
claude mcp add polymarket-toolkit -- npx -y polymarket-toolkit-mcpWhat polymarket-toolkit 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.
What it helps with
- 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 for the agent
- 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
How to install polymarket-toolkit
Platform CLI
claude mcp add polymarket-toolkit -- npx -y polymarket-toolkit-mcpPlatform CLI
codex mcp add polymarket-toolkit -- npx -y polymarket-toolkit-mcpConfig file
{
"mcpServers": {
"polymarket-toolkit": {
"command": "npx",
"args": [
"-y",
"polymarket-toolkit-mcp"
]
}
}
}Config file
{
"servers": {
"polymarket-toolkit": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"polymarket-toolkit-mcp"
]
}
}
}Platform CLI
gemini mcp add polymarket-toolkit npx -y polymarket-toolkit-mcpStep 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-toolkit
How do I install polymarket-toolkit in Claude Code?
Run claude mcp add polymarket-toolkit -- npx -y polymarket-toolkit-mcp. Claude Code will register the stdio server automatically.
Does polymarket-toolkit require an API key or wallet access?
No keys or wallets are needed. The server interacts only with public read-only endpoints and cannot place orders or sign transactions.
What dependencies are needed for the precise PnL script?
Running compute_precise_pnl.py requires Python 3 with the httpx library. Install it using pip install httpx.
