PUBLIC LAUNCH · 1 DEC 2026

Docs · Founding testers

FOUNDING TESTERS · NOVEMBER 2026

Founding testers

25 outside builders run PerpBrain on paper and simulation through November, ahead of the public launch on 1 Dec 2026. Setup takes about 15 minutes and needs no API key, exchange key, wallet or seed phrase.

Never share keysNothing in this setup reads exchange keys, wallets or seed phrases. Don't paste them into a config, a prompt or a feedback form.

The ask

1 · Clone and install (Node 22.6+)

git clone https://github.com/PERPBRAIN/perpbrain-sdk.git
cd perpbrain-sdk/ts/mcp-server && npm ci
cd ../..
pwd

Note the path pwd prints. Below it is REPO_ROOT. On Node 20 or older, or Node 22.0–22.5, the examples stop with bad option: --experimental-strip-types.

2 · Connect Claude Desktop, Cursor or Cline

Add this server block to claude_desktop_config.json (Claude Desktop), Cursor Settings → MCP, or cline_mcp_settings.json (Cline). No secrets:

{
  "mcpServers": {
    "perpbrain": {
      "command": "node",
      "args": ["REPO_ROOT/bin/perpbrain-mcp.mjs"],
      "env": { "PERPBRAIN_HL_NETWORK": "mainnet" }
    }
  }
}

Restart the client. It should list perpbrain with 12 tools. Live reads use the public Hyperliquid /info endpoint only.

3 · First sim

node --experimental-strip-types examples/guarded-simulate.ts
{"case":"standard 1x","label":"SIMULATED","violations":[]}
{"case":"standard 9x","blocked":"GUARD_BLOCKED:LEVERAGE_EXCEEDED"}

The looser leverage is blocked before a fill is recorded. Owner limits are limits you set; losses are still possible.

4 · Verify a receipt

node --experimental-strip-types examples/verify-receipt.ts fixtures/receipts/good
{"dir":"fixtures/receipts/good","status":"VERIFIED","mismatches":[]}

Same inputs, same hashes: verified and reproducible. More on the verify page.

Want a slot?

Email [email protected] with your GitHub or X handle and what your agent does.

Read thisPaper and simulation only. A simulation is a model, not a forecast. It is not advice and places no order.