MCP server exposing 5 tools for polymarket-us.
This URL is a JSON-RPC 2.0 endpoint over HTTP. Issue POST requests with a JSON-RPC body. Browsers and search crawlers land here on GET.
POST https://gateway.pipeworx.io/polymarket-us/mcp
Content-Type: application/json
{"jsonrpc":"2.0","id":1,"method":"tools/list"}polymarket_us_search — Market search/discovery on Polymarket US (polymarket.us) — the SEPARATE, CFTC-regulated, US-licensed venue, distinct from the offshore `polymarket` pack and from `kalshi`. Pass `query` for a keyword search across the full market corpus (returns matching events, each with its child markets and live prices). Omit `query` to BROWSE instead — the highest-volume open markets right now, optionally filtered by `category` (e.g. "macro", "sports", "politics"). Use for "what does Polymarket US have on X", "biggest markets trading right now on the regulated US venue", or as a first step before polymarket_us_bbo / polymarket_us_book / polymarket_us_price_history / polymarket_us_settlement, all of which need a market `slug` this tool returns. Every market price is YES-side implied probability in [0,1].polymarket_us_bbo — Best bid/offer (lightweight top-of-book) for one Polymarket US market by slug — current price, last trade price, best bid, best ask, bid/ask depth (number of price levels), open interest, shares traded, and market state. Use before quoting a price when you need just the top of book, not the full depth ladder (for that, see polymarket_us_book). Get a slug from polymarket_us_search.polymarket_us_book — Full order book (bid/ask depth ladder with size at every visible price level) plus session stats — open/high/low/last-trade price, shares traded, notional traded, open interest — for one Polymarket US market by slug. Use to check actual tradable depth before sizing a trade; polymarket_us_bbo gives only the top of book. Get a slug from polymarket_us_search.polymarket_us_price_history — Historical Yes/No display-price time series for one Polymarket US market by slug. `interval` picks a fixed lookback window (1h | 6h | 1d | 1w | 1m | all); `fidelity` is the spacing between points in minutes (default 60). Returns an array of {timestamp, yes_price, no_price} — these are DISPLAY prices (yes normally derived from the best ask, no from one minus the best bid) and preserve the bid/ask spread, so yes_price + no_price can exceed 1.0 — that is not a data error. Get a slug from polymarket_us_search.polymarket_us_settlement — Settlement (resolution) result for one Polymarket US market by slug — the final settlement price, which is 1 for the winning side / 0 for the losing side on a binary market (and can be a fractional value for a 50/50 or partial settlement). Returns `settled: false` with no price while a market is still open — a market only has a settlement price once Polymarket US has resolved it. Use after polymarket_us_search / a known slug to check how a market actually resolved. NOTE: this tool returns a price only, no settlement timestamp — Polymarket US does not publish one on this endpoint.Code samples (curl / TypeScript / one-click client install), schemas, and the live playground are on the pack page:
https://pipeworx.io/packs/polymarket-us/
Pipeworx is an open MCP gateway connecting AI agents to live data. pipeworx.io