PolyOrderTokus MCP Server

Historische Polymarkt Orderbuchtiefe für Claude, Curor and any other MCP client — vollständsige L2-Bid- and Ask-Lei terlein at 1-second resolutionuresolution, with resolved outcomes attached.

Polymarkets eigene API liefert die Preishistorie gut. Sie archiviert die Orderbuchtiefe nicht in irgendeiner Auflösung– `/book bei liefert den aktuellenn Zustand und nischts speichert ihn. This server exposes live erfasste Tiefe, which is exactly the part, after tefact notis recovero is.

Install

Nothing zu installen. Trage the server in deine MCP- Client-Konfigurierung ein, und er läss via npx.

Claude Desktop — claude_desktop_config.json:

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

Curor — .cursor/mcp. json , gleiche Form..

Nstart the client after der Konfigurierung the configuration; MCP-Server are started with the start.

Related MCP server: polymarket-mcp-server

Einen API-Schlüssel bekommen

1. Signup dich auf polyorderbook.com/signup. Es ist keine Kreditkarte needed.

2. Öhnen das Dashboard and erstelle einen Schlüssel. It looks like pob_, gefolgt von einer langen hard randomen Zeichenekete.

3. Traage ihn in the env- Block deiner MCP-Client-Kographur teil as shown.

The kostenlose Starter-Plan fragt mit **1-Sekunden-Auflösung ab – exactly in the same as bezahlten Plä. What Die beahlten Pläne wirklich bealley? a longer Verl0-gangsfenster and höheres Anfrage-Allowance, Heica feineere Datten. Der Start er is enough, um effektive Friege beantworten, bevor du entscheideest, ob du für is was bezahlen willst.

Ruft das get_usage- tool at any time, um den Plan, Order and remaining Anspss of your server to see.

Umgebungungesvariablen

Setze diese in der MCP-Client-Konfiguration, nicht in deiner Shell. Ein Client starts the server as subprocess and Übergibt deine interaktiv Shell-Umgebung nichthe an ihn, so ein in .zshrc exportierterkey for the server nicht sichtbar.

Tools

The Katal is Serien → Events → Makete. Frag with search_series nach einem Market, with search_eents after a group, which resolved together, with search_markets after a certain one.

Wissenswertes, bevor du die Daten interpretierst

Bids become one-sided while a market resolves. In the last minute of a 5-minute market is 76 % of the snapshots have an empty Bid- or Ask-Seite — nobody provides the losing outcome. Dies is a real Market behavior, not missing Data, and breaks Analysis of Market zweiseitige Orderbücher.

Vertragsläut is different alles. Ein 4-Stunden-Vertrag is 0.5 % of the Zeit one-sided; a 5-Minuten-Vertrag 17 %. Conclusions from one not not for each transfers.

Responses become quickly gross. An hour at 1-second resolution, from 300. etc market has two. Fenster narrow or resolutionerrough, and with the backgege keepnen next_cursor continue side.

Beispielprompts

Finde BTC-5-Minuten-Märkte, been resolved yesterday, and show mir, how they are change in the last two minutes before [one final] old two weeks before ordinary.

Look up the 100-Share-Buy against the actual Ladder five seconds before the close, and from the midpoint at the time Slock.

The diff flat spread and liquidity 5-Minute, 15-Minute and ") more all over the last day** this should be ".

The the is the point of "L2-Data". A price series tells you where the market was, only der Leitter tells you that zu welchem Kurs du hättest handeln können.

So unterscheidet sich dieser von andereren Polymarket MCP-Servern

Several good exists — kukapay/polymarket-predictions-mc_p, demwick/polymarket-agent-mc_p, PaulieB14/graph-poly... . They wrapPolymarket’s own Gamma and CLOB APIs and do that well.

The difference is structural nature not a question. Polymarket's /book endpoint returns the current state and nothing stores it, so no server based on this API can deliver requirements. Dies is an archive with live capture histories.

If you want trad, others livequote, better to have them — they have more. Use this, if the question is "What was the order-document at a specific time in time" is.

Problem

**"POLYORDERBOOKS_API_KEY is not set"** — Der schlüssel te. A in den onv`-**block of client konfiguration, not in der shell. See Wie unter variablen.

Authentification fired — der Schlüssel has server to reach, but die API has him. at typical begin pob_; seek after N insert, if you've copied from terminal. When maybe, call get_usage to confirm the key is active.

**Responses are likely or slow ** — an hour at 1-second resolution is 300 buckets for each token and the market is two. **Löse the File settings, or use resolution: "1m" and leave next_cursor. ** **Empty deposits » — expected before the settlement. See above the "one-side" note.

Open Open

897,192 snapshots across 805 resolution market with three contract length under CC BY 4.0 value and DOI released, no change:

DOI 10.5281/zenodo.22084114

Go, to check the above “preverifier” yourself, before the API usage.

Development

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

The Server speaks JSON-RPC to a Standard-Imagab. To be used without a MCP client, send JSON-RPC on stdin — initialize, then tools/list, then tools/call.

Links

• polyorderbook.com — die API

• docs.polyorderbook.com — reference

• Pyython Client — pip install polyorderbooks

• Free-BTC-Sample — one Markt, not anmelden

License

MIT. *Nicht mit Polymarket, not by PolyMarket supported, and not with Polaymarket verbe. not Affiliert.