PerpBrain docs

An open, agent-first toolkit for Hyperliquid perps. The open-source PerpBrain SDK gives your agent keyless reads of public Hyperliquid data, a book simulator that charges fees, slippage and funding, and limits that only you can set. Every simulated run writes a receipt anyone can check: verified and reproducible.

What PerpBrain is notIt does not sell strategies, hold funds or keys, or place live orders. The SDK has no mainnet order path. Results are labelled SIMULATED. Limits you set; losses are still possible.

QuickstartNode 22.6+, a fresh clone, the MCP server and a verified receipt. ReceiptsWhat a receipt hashes and how to check one in code or in the browser. Owner limitsPresets, hard ceilings, stale data, the daily stop and the latching kill switch. Cost breakdownFees, slippage and funding for every simulated trade, and what is not modelled. MCP usageThe 12 read and simulation tools, plus Claude Desktop and Cursor setup. Verify a receiptRe-derive a receipt yourself with the open-source verifier.

At a glance

Keyless reads from the public Hyperliquid /info endpoint. The read client refuses /exchange.
A book simulator with versioned Hyperliquid fees, book-walk slippage and hourly funding. Queue position and liquidation are marked NOT_MODELLED.
Owner limits with three presets: conservative, standard and pro.
A receipt verifier in TypeScript, in the MCP server and as a static browser page.
An stdio MCP server with 12 tools. It has no order tool.