PolyOrderbooks MCP Server

Profundidad histórica del libro de órdenes de Polymarket for Claude, Cur or and any other MCP client — full ladders L2 de compra and vent in a resolución of 1 second, with the results resolved attached.

![npm](https://img.shields.io/npm/v/@polyorderbooks/mcp-server

La propia API de Polymarket offers a good historical price info. There is not the "livan en eva" wants at any level: /book devuelve el estado actual y nada lo stores. Este servidor expone una profundidad que se capturó en directo, la parte que no se puede recuperar con posterioridad.

Instalación

Nada que instalarar. Añádelo a la configuación de tu cliente MCP y se ejecutará mediante npx.

Claude Desktop — claude_desktop_config.json:

{
  "mcpServers": {
    "polyorderbooks": {
      "command": "npx",
      "args": ["-y", "@polyorderbooks/mcp-server"],
      "env": { "POLYORDERBOOKS_API_KEY": "pob_..." }
    }
  }
}

Cursorne — .cursor/mcp.json, con la sama estructura.

Reinicia el cliente después de editar la configura; los servidores MCP se lanzan al arrancar.

Related MCP server: polymarket-mcp-server

Obtener una clave de API

1. Registrate en polyorderbooks.com/signup. No se requiera tarjeta.

2. Abre el panel and crea una clave. Tiene el formato pob_ aaja de una cade larga aleatoria.

3. Colócala en el bloque env de la configuración de tu cliente MCP, equivalente a lo anterior.

El plan gratuito Starte tipo espera con resolución de 1 segundo, igual that "paid plans. Lo que añaden los planes de pago es una ventana de historial o lo largo y de límite de peticiones más alto, no datos más finos. Starte es suficiente para responder a una pregunta real antes de decides if pay anything.

Pon la llamada a el herramienta get_usage en cualquier momento para ver el plan, the limit and la quota restante in the key que hayas configurado.

Variables de entorno

| Variable | Obligatoria | Propósito | |--|--| El API key | si | Tu clave de API. La servidor se cierra al arrancar if falta, in lugar del fall to la primera llamada to el herramienta. | URL base de POLYORDERBOOKS | no | Reescribe la URL base de la API. Su valor por automatic is https://api.polyorderbooks.com. Solo is needed for "self-hosted" or "stage" deployments. |

Configure them in the MCP client config, not in your shell. **The client lanza the server as a subproceso y no le pasa tu entorno de shell interactivo; so una clave exportada in .zshrc no será visible para el servidor.

Herramientas

The catalogue is series → events → markets. Ask for a type of market with search_series, a group that resolves together with search_events, and a specific one with search_markets.

Things worth knowing before using the data

Books become single-sided when the markets to be settle. In the last minute of a 5-minute the market, 76% of the captures have one side — the buy side or the sell side — empty, no one wants to offer. "Esto es real behavior del mercado, no falta de datos, y es rompe the analysis that assume books from of casual.

Duracion del contrato lo cambia todo. Un contrato de 4 houras tiene un solo lado un 0.5% de tiempo; de 5 minutes, 17%. Conclusiones from the first time cannot be traspasadas to other.

Responses become large quickly. Una aun at a 1 second resolution has 3.600 instances per token, and a market has a two. Mítén ventana de tiempo o reducir velocidad a widows, and con next_cursor you can page.

Prompt examples

Encontra mercados de BTC de 5 minutes que se resolvieron ayer and enséname as "ays" or the formula in the last two minutes before the liquidation.

Para este mercado, ¿cuánto habría costado a compra de 100 acccions against el "or" "Lader real cinco the segundos antes del cierre, enlugar del punto medio en which if moment?

Compare el adelante and the liquidity between the BTC contracts of 5 minutes, 15 minutes and 4 hours during the day before.

The second one eso. Eso, el punto de los datsos L2: A sequence of prices says dónde is the market; una charer puede decir the amount at which que you could have operated.

Cómo se diferentes de otros MCP servers "Polymarket"

There are several good stacks: kukapay/polymarket-predictions-mcp, polymarket-agent-mcp, graph-polymarket-mcp.

| | These | This | |--|--| | The action and current count | yes | no | | "Trade" | "%" none | | Metadata and settlement of markets | yes | yes | | Historical price | 1 minute, from Polymarket | 1 second | | Historical order book depth | not available | yes |

La diferencia es estructural, not a cuestión de esfuerzo. Polimarket's /book endpoint returns the current state and nothing archives it, so that a server builded on this API will not be able to serve the ladders of yesterday. This server "reads" an archive that was captured live.

If you want to trade, in operation, or you want "live" odds, use a of theirs — they cover that better. Use this when the price is about the "book" in a specific point in the past.

Troubleshooting

"POLYORDERBOOKS_API_KEY is not set" — missing "the key". La clave should be in the block env of the client config, not in your shell. See Environment variables.

Auth failed — the key reached the server but the API rejected it. Claves start with draws_check; check for the newline at the end or a leftover quote if you have it from terminal. If it looks good, call get_usage to verify if the key is active.

Truncated responses or old — one hour at 1-second resolution is 3,600 buckets per token, and a market has two. Reduce the window, or use resolution: "1m" and page with next_cursor.

Empty chairs — on the other side of the empty launcher. Look at the note to see the date.

Public data

89,192 captures 8,805 markets and 3,400 contracts have been published under int if unknown, without new.

But this will definitely. Use nothing else: go with 1 doc something.

The DOI:

Development

npm install
npm run build
POLYORDERBOOKS_API_KEY=pob_... npm run dev

The server uses stdio. To test it without a MCP client, send JSON-RPC on stdin — initiale, then tools/list, then tools/call.

Links

• polyorderbooks.com — the API

• docs.polyorderbooks.com — reference

• Python client — pip install polyorderbooks

• Free BTC sample — the data is free

Licence

MIT. Not affiliated with Polymarket.