mcpField
T
tool-polymarket-book

tool-polymarket-book

github.com/captaindptOther039 installsUpdated 41w ago
Repository

About tool-polymarket-book

A Polymarket CLOB order-book lookup tool for checking liquidity, spread, depth, and midpoint by market and outcome. It returns structured book data and a rendered view, including when no order book is available.

Key features

  1. 01Look up a market by ID
  2. 02Select YES or NO outcome
  3. 03Set order-book depth
  4. 04Return bids, asks, and midpoint
  5. 05Report unavailable order books

Use cases

  1. 01Check liquidity before sizing a position
  2. 02Estimate a market’s spread and midpoint

MCP support

The input describes a tool but does not state that it is exposed through MCP.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/captaindpt/truth-terminal --skill tool-polymarket-book

After installing, type/tool-polymarket-bookin Claude Code to confirm it loaded.

Details

From the project README

polymarket_book (Polymarket CLOB book)

When to use

  • Liquidity check before sizing into a market.
  • Spread + depth + mid estimation.

Parameters

  • marketId (string, required): Gamma numeric id (e.g. "516710") or conditionId hex ("0x...").
  • outcome ("YES" | "NO", optional): Defaults to "YES".
  • depth (int, optional, 1–200): Levels per side; default 20.

Examples

{ "name": "polymarket_book", "params": { "marketId": "0xabc...def", "outcome": "YES", "depth": 50 } }

Output

  • Returns: { marketId, conditionId, question, slug, endDate, outcome, tokenId, bookAvailable, bestBid, bestAsk, mid, bids[], asks[], ts }
  • Rendered:
    • Emits a JSON output with title orderbook (used by the UI to open/focus a book window when available).
    • Market (text with mid/bid/ask and “no CLOB orderbook” when missing)
    • Asks + Bids (tables)

Notes

  • Some markets have no CLOB orderbook; the tool returns bookAvailable=false and empty bids/asks.
  • targetWindow: book

Comments

Markdown supported