Pmq (Polymarket CLOB V2) MCP Server

Fail-closed Polymarket CLOB V2 data and execution; trading tools gated behind PMQ_MCP_LIVE=1.

Remote serverstreamable-httpPython

What is the Pmq (Polymarket CLOB V2) MCP Server?

Fail-closed Polymarket CLOB V2 data and execution; trading tools gated behind PMQ_MCP_LIVE=1.

The short version

Fail-closed execution and market data for Polymarket CLOB V2, in Python, built agent-first. Local signing (your keys never leave your process), exchange-confirmed fills only, fee-correct math, deposit-wallet (POLY_1271) support that actually works in production, order-attribution registries (several bots can share one wallet, each with its own exchange-truth accounting), and a bundled MCP server: plug any LLM or agent framework that speaks MCP (Claude, ChatGPT, LangChain, your own loop) on top and it can read every market and, if and only if the operator enables it, trade under hard rails: tools that

  • invalid amounts, the market buy orders maker amount supports a max accuracy
  • no orders found to match with FAK order (HTTP 400, yet with an orderID):
  • CLOB shows balance: 0 while your pUSD sits on-chain: the balance endpoint

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
signature_typeWallet
pmq_statusnothing
find_marketsnothing
eventnothing
marketnothing
market_snapshotnothing
booknothing
order_previewnothing
taker_feenothing
account_collateralpaper mode, or keys
account_tradespaper mode, or keys
account_portfoliopaper mode, or public wallet
fak_buyPMQ_MCP_PAPER=1, or keys plus PMQ_MCP_LIVE=1

How to install the Pmq (Polymarket CLOB V2) MCP Server

{
  "mcpServers": {
    "pmq": {
      "command": "uvx",
      "args": ["--from", "pmquant[mcp]", "pmq-mcp"],
      "env": {
        "PMQ_MCP_LIVE": "1",
        "PMQ_MCP_MAX_USD": "10",
        "PMQ_MCP_DAILY_USD": "25",
        "POLY_PRIVATE_KEY": "...",
        "POLY_FUNDER": "0x...",
        "POLY_SIG_TYPE": "3"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
PMQ_MCP_PAPERConfiguration value read at startup.Optional
PMQ_MCP_LIVEConfiguration value read at startup.Optional
PMQ_MCP_MAX_USDConfiguration value read at startup.Optional
PMQ_MCP_DAILY_USDConfiguration value read at startup.Optional
POLY_PRIVATE_KEYCredential the server authenticates with.Yes
POLY_FUNDERConfiguration value read at startup.Optional
POLY_SIG_TYPEConfiguration value read at startup.Optional

Example prompts to try

  • “Use Pmq (Polymarket CLOB V2) to Situation.”
  • “Use Pmq (Polymarket CLOB V2) to signature type.”
  • “Use Pmq (Polymarket CLOB V2) to pmq status.”

Frequently asked questions

Fail-closed Polymarket CLOB V2 data and execution; trading tools gated behind PMQ_MCP_LIVE=1. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.