mcpField
P
pmq (Polymarket CLOB V2)

pmq (Polymarket CLOB V2)

Local
github.com/crp4222Finance
Repository

About pmq (Polymarket CLOB V2)

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

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "crp4222-pmq": {
      "command": "uvx",
      "args": [
        "pmquant"
      ],
      "env": {
        "PMQ_MCP_LIVE": "<PMQ_MCP_LIVE>",
        "PMQ_MCP_PAPER": "<PMQ_MCP_PAPER>",
        "PMQ_MCP_PAPER_USD": "<PMQ_MCP_PAPER_USD>",
        "PMQ_MCP_MAX_USD": "<PMQ_MCP_MAX_USD>",
        "PMQ_MCP_DAILY_USD": "<PMQ_MCP_DAILY_USD>",
        "PMQ_MCP_STATE_FILE": "<PMQ_MCP_STATE_FILE>",
        "POLY_PRIVATE_KEY": "<POLY_PRIVATE_KEY>",
        "POLY_FUNDER": "<POLY_FUNDER>",
        "POLY_SIG_TYPE": "<POLY_SIG_TYPE>",
        "POLY_ORDER_LOG": "<POLY_ORDER_LOG>",
        "POLY_FOREIGN_ORDER_LOGS": "<POLY_FOREIGN_ORDER_LOGS>"
      }
    }
  }
}
Run commanduvx pmquant
Environment variables to set
PMQ_MCP_LIVESet 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_PAPERSet 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_USDInitial paper balance in USD when a new state file is created (default 1000). Only relevant when PMQ_MCP_PAPER=1.
PMQ_MCP_MAX_USDPer-order hard cap in USD enforced before any buy, live and paper alike (default 10).
PMQ_MCP_DAILY_USDDurable cumulative BUY budget per UTC day (off when unset). Unknown live results retain the requested reservation through that UTC day.
PMQ_MCP_STATE_FILELocal durable paper-ledger and daily-budget file. Defaults to $XDG_STATE_HOME/pmq or ~/.local/state/pmq; it contains no key material.
POLY_PRIVATE_KEYSecretEOA 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_FUNDERFunder wallet address. Required with signature_type > 0 (deposit wallets); also an optional default for public account_portfolio reads.
POLY_SIG_TYPEPolymarket signature type: 0 EOA, 1 POLY_PROXY, 2 POLY_GNOSIS_SAFE, 3 POLY_1271 (app deposit wallet). Run pmq-doctor if unsure.
POLY_ORDER_LOGAppend-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_LOGSColon-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.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypipmquant0.7.1

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

The maintainer has not added details yet. Check the README in the repository.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.