`polymarket_us_search`

Pack: polymarket-us · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/polymarket_us_search for the schema, then POST the same URL with its arguments for the data.

Polymarket US markets matching a keyword, or the highest-volume open markets, each with live prices.

Tool description as the model sees it

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

Parameters

Name	Type	Required	Description
`query`	string	no	Keyword search, e.g. “fed rate”, “election”, “nfl”. Omit to browse the highest-volume open markets instead.
`status`	string	no	open \| closed (default open). With a query, filters the search; without one, “open” means active & not closed, “closed” means closed.
`category`	string	no	Browse-only filter, e.g. “macro”, “sports”, “politics”, “crypto”. Ignored when `query` is set (Polymarket US search has no category filter).
`limit`	number	no	1–50 results (default 10)

Example call

Arguments

{
  "query": "fed funds",
  "limit": 3
}

curl

curl -X POST https://gateway.pipeworx.io/polymarket-us/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"polymarket_us_search","arguments":{"query":"fed funds","limit":3}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('polymarket_us_search', {
  "query": "fed funds",
  "limit": 3
});

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}

Connect to just the polymarket-us pack

{
  "mcpServers": {
    "polymarket-us": {
      "url": "https://gateway.pipeworx.io/polymarket-us/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

polymarket_us_search