predictDEX

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Live Polymarket odds, order books, fee-inclusive quotes and non-custodial prediction trading.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "predictDEX": {
      "url": "https://predict.dex.mk/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (11)

• search_markets read-only

  Find events and their markets with live odds. Filter by free-text query, category slug (see predict://categories), sort and status. Each event lists markets with outcomes, token ids, best bid/ask, tick size and a human URL.

  Parameters:

  • q — string — Free-text search, e.g. 'fed rate october' or 'bitcoin 150k'
  • sort — string — Sort order
  • limit — integer — Events to return (1-50, default 20)
  • offset — integer — Pagination offset
  • status — string — active (default), resolved or all
  • category — string — Category slug, e.g. politics, crypto, sports, new, breaking, ending
  • maxMarkets — integer — Markets per event (1-50, default 5)

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_event read-only

  Full event by slug: every market, outcome names and prices, token ids, tick size, min order size, rules summary, resolution source and status. Optionally include recent trades.

  Parameters:

  • slug (required) — string — Event slug from search_markets
  • recentTrades — integer — Include up to N recent trades (0-50)

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_orderbook read-only

  Live order book for one outcome token: bids and asks (price 0-1, size in shares), spread, midpoint and last trade.

  Parameters:

  • tokenId (required) — string — Outcome token id (digits) from get_event
  • depth — integer — Levels per side (1-100, default 20)

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_price_history read-only

  Price (probability) history for one outcome token over a range.

  Parameters:

  • tokenId (required) — string — Outcome token id
  • range — string — Time range

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• quote_order read-only

  Preview an order against the live book without placing it: average and worst price, shares, cost, payout if the outcome wins, Polymarket fee, predictDEX fee and warnings. Market BUY amount is USD to spend all-in; market SELL and limit amounts are shares.

  Parameters:

  • tokenId (required) — string — Outcome token id
  • amount (required) — number — USD for a market BUY, shares otherwise
  • side — string — BUY or SELL
  • type — string — market (default) or limit
  • price — number — Limit price as probability 0-1 (required for limit)
  • postOnly — boolean — Limit orders: rest only, never take
  • slippage — number — Market orders: max price move in price units, e.g. 0.02
  • orderType — string — FAK/FOK for market, GTC/GTD for limit
  • expiration — integer — GTD expiry, unix seconds

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_trading_setup read-only

  Everything an agent with its own wallet needs to trade: chain, collateral (pUSD), builder code, signer URL, attestation steps, fees and a ready-to-run TypeScript snippet using Polymarket's official SDK. Non-custodial: you sign with your own key.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• create_trade_link read-only

  A pre-filled predictDEX ticket URL (event, market, outcome, side, amount) for a person to review and sign in their own wallet. Opening it executes nothing. Use this when you have no wallet or need human confirmation.

  Parameters:

  • slug (required) — string — Event slug
  • side — string — BUY or SELL
  • amount — number — USD to spend for BUY, shares for SELL
  • market — string — Market id or conditionId (defaults to the event's main market)
  • outcome — string — 0 = first outcome (Yes), 1 = second (No)

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_positions read-only

  Open positions of a Polymarket trading account or its owner address: size, average price, current price, value and P&L.

  Parameters:

  • address (required) — string — 0x address (owner EOA or Deposit Wallet)

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_leaderboard read-only

  Top Polymarket traders by profit or volume over a window.

  Parameters:

  • limit — integer — Rows (1-100, default 25)
  • metric — string — Ranking metric
  • window — string — Time window

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_agent_challenge read-only

  Returns the canonical 'predictDEX Agent Attestation v1' message for your address. Sign it with EIP-191 personal_sign within 10 minutes and pass it to attest_agent.

  Parameters:

  • address (required) — string — Your 0x wallet address

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• attest_agent

  Submit the signed attestation. Returns a 30-day agent token that unlocks gasless Polymarket account setup through predictDEX's signer for your address only. It grants no custody and no exemption from region rules.

  Parameters:

  • address (required) — string — 0x address that signed
  • message (required) — string — The exact challenge message
  • signature (required) — string — 0x EIP-191 signature

  Hints: read-only no · destructive no · idempotent no · open-world yes

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.