pmq (Polymarket CLOB V2)

io.github.crp4222Published by GitHub account crp4222v0.7.1Updated Oct 25, 2026

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

VerifiedSTDIODesktop onlyFinanceBusiness & Commerce

Overview

AI-generated overview

A local MCP server for Polymarket CLOB V2 trading and market data, with read-only mode by default and optional paper or live order tools.

What you can do
Read Polymarket CLOB V2 market and account data, including public portfolio reads for a funder wallet address when configured (no tools are listed in the manifest, so this is drawn from the description and variable notes). Optionally register trading tools for placing and cancelling orders: fak_buy, fak_sell and cancel_and_reconcile, enabled only when live mode is switched on. Simulate fills against real order books in paper mode, with a configurable starting balance and a local ledger file. Enforce spending limits: a per-order USD cap and an optional cumulative daily buy budget. Attribute orders and reconcile trades when several order senders share one wallet, using local order-log and peer
When to use it
Use it when you want an assistant to inspect Polymarket CLOB V2 markets and account data, or to place and manage orders on Polymarket from your own machine. Paper mode is the sensible first step to test strategies without keys or real orders.
Requirements
Runs locally as a Python package (pmquant) via uvx on a desktop machine; stdio transport. Read-only by default. Live trading needs POLY_PRIVATE_KEY and typically POLY_SIG_TYPE, plus POLY_FUNDER for deposit-wallet signature types. Optional settings include PMQ_MCP_LIVE, PMQ_MCP_PAPER, PMQ_MCP_MAX_USD, PMQ_MCP_DAILY_USD, PMQ_MCP_PAPER_USD, PMQ_MCP_STATE_FILE, POLY_ORDER_LOG and POLY_FOREIGN_ORDER_LOGS. Network access to Polymarket is implied.
Before you install
Live mode places real orders and spends real money; POLY_PRIVATE_KEY is a wallet private key used to sign orders locally, so treat it as highly sensitive. Spending caps (PMQ_MCP_MAX_USD, PMQ_MCP_DAILY_USD) are the main guardrails and should be set deliberately. Order attribution and reconciliation are only sound if every other order sender on the wallet keeps a registry file. Paper mode needs no keys and places no exchange orders.

Installation

In SourceWeft

  1. Open pmq (Polymarket CLOB V2) in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

This repository has no README.

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.7.1LatestSep 16, 2026

Score

25% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • License10 pts

    Declare a license in the repository or the registry entry.