Back to Browse

Pmq MCP Server

Developer ToolsLow Risk10.0MCP RegistryLocal
Free

Server data from the Official MCP Registry

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

About

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

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (1 strong, 3 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.

4 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

file_system

Check that this permission is expected for this type of plugin.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

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

Environment variable: PMQ_MCP_LIVE

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

Environment variable: PMQ_MCP_PAPER

Initial paper balance in USD when a new state file is created (default 1000). Only relevant when PMQ_MCP_PAPER=1.Optional

Environment variable: PMQ_MCP_PAPER_USD

Per-order hard cap in USD enforced before any buy, live and paper alike (default 10).Optional

Environment variable: PMQ_MCP_MAX_USD

Durable cumulative BUY budget per UTC day (off when unset). Unknown live results retain the requested reservation through that UTC day.Optional

Environment variable: PMQ_MCP_DAILY_USD

Local durable paper-ledger and daily-budget file. Defaults to $XDG_STATE_HOME/pmq or ~/.local/state/pmq; it contains no key material.Optional

Environment variable: PMQ_MCP_STATE_FILE

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

Environment variable: POLY_PRIVATE_KEY

Funder wallet address. Required with signature_type > 0 (deposit wallets); also an optional default for public account_portfolio reads.Optional

Environment variable: POLY_FUNDER

Polymarket signature type: 0 EOA, 1 POLY_PROXY, 2 POLY_GNOSIS_SAFE, 3 POLY_1271 (app deposit wallet). Run pmq-doctor if unsure.Optional

Environment variable: POLY_SIG_TYPE

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

Environment variable: POLY_ORDER_LOG

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

Environment variable: POLY_FOREIGN_ORDER_LOGS

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-crp4222-pmq": {
      "env": {
        "POLY_FUNDER": "your-poly-funder-here",
        "PMQ_MCP_LIVE": "your-pmq-mcp-live-here",
        "PMQ_MCP_PAPER": "your-pmq-mcp-paper-here",
        "POLY_SIG_TYPE": "your-poly-sig-type-here",
        "POLY_ORDER_LOG": "your-poly-order-log-here",
        "PMQ_MCP_MAX_USD": "your-pmq-mcp-max-usd-here",
        "POLY_PRIVATE_KEY": "your-poly-private-key-here",
        "PMQ_MCP_DAILY_USD": "your-pmq-mcp-daily-usd-here",
        "PMQ_MCP_PAPER_USD": "your-pmq-mcp-paper-usd-here",
        "PMQ_MCP_STATE_FILE": "your-pmq-mcp-state-file-here",
        "POLY_FOREIGN_ORDER_LOGS": "your-poly-foreign-order-logs-here"
      },
      "args": [
        "pmquant"
      ],
      "command": "uvx"
    }
  }
}

Reviews

No reviews yet

Be the first to review this server!