pmq (Polymarket CLOB V2) MCP Server

by crp4222io.github.crp4222/pmqv0.7.1

Production-proven Polymarket CLOB V2 trading and data. Fail-closed fills; keys stay local.

Pythonstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Maintained3mo ago

Install pmq (Polymarket CLOB V2) MCP server

claude mcp add pmquant -e POLY_PRIVATE_KEY='<poly-private-key>' -- uvx pmquant

{
  "mcpServers": {
    "pmquant": {
      "command": "uvx",
      "args": [
        "pmquant"
      ],
      "env": {
        "POLY_PRIVATE_KEY": "<poly-private-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "pmquant": {
      "command": "uvx",
      "args": [
        "pmquant"
      ],
      "env": {
        "POLY_PRIVATE_KEY": "<poly-private-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "pmquant": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "pmquant"
      ],
      "env": {
        "POLY_PRIVATE_KEY": "<poly-private-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "pmquant": {
      "command": "uvx",
      "args": [
        "pmquant"
      ],
      "env": {
        "POLY_PRIVATE_KEY": "<poly-private-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
PMQ_MCP_LIVE	—	—	Set to 1 to register the LIVE trading tools (fak_buy, fak_sell, cancel_and_reconcile). Overridden by PMQ_MCP_PAPER=1; with neither set the server is read-only.
PMQ_MCP_PAPER	—	—	Set to 1 for paper trading: trading tools simulate displayed top-of-book fills against real books. No keys or exchange orders. Wins over PMQ_MCP_LIVE.
PMQ_MCP_PAPER_USD	—	—	Initial paper balance in USD when a new state file is created (default 1000). Only relevant when PMQ_MCP_PAPER=1.
PMQ_MCP_MAX_USD	—	—	Per-order hard cap in USD enforced before any buy, live and paper alike (default 10).
PMQ_MCP_DAILY_USD	—	—	Durable cumulative BUY budget per UTC day (off when unset). Unknown live results retain the requested reservation through that UTC day.
PMQ_MCP_STATE_FILE	—	—	Local durable paper-ledger and daily-budget file. Defaults to $XDG_STATE_HOME/pmq or ~/.local/state/pmq; it contains no key material.
POLY_PRIVATE_KEY	—	yes	EOA private key used only to sign orders locally when trading tools are enabled. Never printed or transmitted. Not needed for the read-only tools.
POLY_FUNDER	—	—	Funder wallet address. Required with signature_type > 0 (deposit wallets); also an optional default for public account_portfolio reads.
POLY_SIG_TYPE	—	—	Polymarket signature type: 0 EOA, 1 POLY_PROXY, 2 POLY_GNOSIS_SAFE, 3 POLY_1271 (app deposit wallet). Run pmq-doctor if unsure.
POLY_ORDER_LOG	—	—	Append-only file of this server's own order ids. Enables order attribution when several senders share one wallet: account totals then count only orders placed through this server. Optional; without it behavior is unchanged.
POLY_FOREIGN_ORDER_LOGS	—	—	Colon-separated registry files of the wallet's other order-senders. Reconciliation claims trades unknown to every registry. Sound only if every sender on the wallet keeps a registry.

Freshness

Maintained — last maintenance signal 3mo ago. The newest of the signals below sets the band.

Last commit (default branch)
no data · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-07-14 · 3mo ago · official registry · v0.7.1

FAQ

›How do I install the pmq (Polymarket CLOB V2) MCP server in Claude Code?

Run: claude mcp add pmquant -e POLY_PRIVATE_KEY='<poly-private-key>' -- uvx pmquant. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does pmq (Polymarket CLOB V2) require an API key?

Yes. It expects POLY_PRIVATE_KEY, of which 1 is a secret.

›Can I use pmq (Polymarket CLOB V2) as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is pmq (Polymarket CLOB V2) in the official MCP registry?

Yes, as io.github.crp4222/pmq.