polymarket-book-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_marketsA | Search Polymarket markets by keyword via the site's real search backend (Gamma's own /markets?search= is a no-op and ignores the query). Returns a flat list of markets with best bid/ask, spread and outcome/token ids, flattened out of their parent events. |
| get_order_bookA | Fetch the live order book for one outcome token: best bid/ask, mid, spread, and the top N levels per side with cumulative size and notional. This is the central tool of this server. |
| get_marketA | Resolve a polymarket.com market URL or bare slug into its question, condition_id, per-outcome token ids, tick size, LP reward band, and active/closed/accepting_orders status. |
| get_quoteA | Cheap price check for one outcome token: best_bid, best_ask, mid and spread only, no depth. One book fetch. |
| get_price_historyA | Historical price series for one outcome token, plus a small summary (count, first, last, min, max). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 5 tools
Tools are mostly distinct: search_markets finds markets, get_market resolves a specific market, get_order_book provides full depth, get_quote provides a quick price snapshot, and get_price_history gives historical data. The only potential overlap is get_quote versus get_order_book, but the descriptions clearly differentiate a lightweight price check from full depth.
All tool names follow a consistent verb_noun pattern with lowercase and underscores: search_markets, get_market, get_order_book, get_quote, get_price_history. This is highly predictable and maintains a uniform style throughout.
Five tools is a well-scoped set for a market data server, covering search, resolution, current pricing (both depth and quick quote), and historical data. Each tool earns its place without unnecessary redundancy or bloat.
The server covers the core market data lifecycle: discovering markets, resolving identifiers, retrieving current order book depth, getting quick quotes, and accessing price history. Minor gaps like trade history or volume data exist, but the set is adequate for the stated purpose of a book-focused MCP.