perpad MCP server
Commit 13 Nov 2026Memungkinkan AI agent untuk melakukan perpetual trading secara otonom di Hyperliquid dengan penegakan risiko deterministik dan journal yang tamper-evident.
Juga dikenal sebagai nirholas/perpad
- Stars
- 4
- Tools
- —
- Unduhan, 30 hari
- —
- Versi terbaru
- —
- Commit terakhir
- 13 Nov 2026
- Lisensi
- MIT
Apa itu perpad MCP?
Memungkinkan AI agent untuk melakukan perpetual trading secara otonom di Hyperliquid dengan penegakan risiko deterministik dan journal yang tamper-evident.
Ringkasan dibuat dari README proyek
Tentang perpad MCP server
Mengeksekusi perpetual trades secara otonom di Hyperliquid dengan guardrails keamanan yang ketat adalah fungsi utama perpad bagi developer yang sedang membangun AI trading agents. Berbeda dengan implementasi standar yang hanya mengandalkan instruksi model, sistem ini menggunakan deterministic risk engine yang ditulis dalam kode murni untuk menegakkan batasan yang tidak bisa diubah oleh LLM. Sistem ini mengelola isolated-margin perps untuk aset seperti BTC dan ETH sambil memastikan setiap action mengikuti constraint yang telah ditentukan.
User dapat men-deploy ini dalam paper mode menggunakan simulasi fills dan harga real, atau langsung live dengan menyediakan Hyperliquid API wallet key dan alamat akun. Setup ini memerlukan Anthropic API key untuk logika agentic-nya. Untuk memastikan akuntabilitas, server ini mengelola SHA-256 hash-chained journal yang mencatat setiap thought, action, dan refusal dalam format JSONL. Hal ini memungkinkan verifikasi riwayat pengambilan keputusan agent dengan mudah melalui command perpad verify.
Apa yang bisa Anda lakukan dengannya
- 1Simulasikan strategi trading dengan amanTes logika trading otonom menggunakan harga market real dan simulasi fees tanpa mempertaruhkan modal asli.
- 2Audit riwayat keputusan agentVerifikasi integritas log trading agent untuk memastikan tidak ada entri yang telah dimanipulasi.
- 3Monitor data market via MCPGunakan MCP server untuk memungkinkan AI client memeriksa market yang tersedia dan mengecek status risiko saat ini.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Konfigurasi
ANTHROPIC_API_KEY
| Nama | Deskripsi | Tipe |
|---|---|---|
| ANTHROPIC_API_KEY | — |
Pengecekan otomatis
Berjalan 14 Nov 2026Laporan lengkap →Belum diverifikasi. Sebuah server memerlukan skor 80, tidak ada temuan serius, dan data yang cukup untuk kami periksa. Cara kerja checks · Yang perlu diperbaiki untuk menambah poin
- Source repository terhubung dan dapat dijangkaunirholas/perpad is public and reachablegithub.com/nirholas/perpad ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernyaTidak diperiksa
- Provenance build (atestasi Sigstore)Tidak diperiksa
- Lisensi open source (OSI)MITspdx.org/licenses/MIT.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-11-13github.com/nirholas/perpad ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerTidak diperiksa
- Tidak ada advisory kritis pada paket atau dependensinyaTidak diperiksa
- Tidak ada instruksi tersembunyi untuk model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelTidak diperiksa
- Endpoint remote merespons handshake MCPTidak diperiksa
README
Lihat di GitHubperpad
Autonomous perp-trading agents on Hyperliquid, with limits the model cannot override.
Docs · Quickstart · Risk engine · Roadmap
An LLM agent reads live BTC and ETH prices from Hyperliquid, checks its account, then opens or closes isolated-margin perps. Every order passes a deterministic risk engine. Every thought, action and refusal is written to a hash-chained journal anyone can verify.
┌────────────┐ 5 tools ┌──────────────┐ clamp / deny ┌────────────┐
tick → │ Claude │ ─────────▶ │ risk engine │ ─────────────▶ │ venue │ → Hyperliquid
│ (agent) │ ◀───────── │ (pure code) │ │ live/paper │
└─────┬──────┘ verdicts └──────────────┘ └────────────┘
└──────────── every step ──▶ hash-chained journal (JSONL)
Why
Most trading-agent demos give a model an exchange key and hope. perpad inverts that. The model has five tools and no way to withdraw, transfer, change limits or use cross margin. The only path to an order runs through code that reads live exchange limits. If the model asks for 100x on a 40x market it gets 40x or a refusal, and the refusal is journaled.
Quickstart (paper mode, no exchange key)
git clone https://github.com/nirholas/perpad && cd perpad
npm install && npm run build
export ANTHROPIC_API_KEY=sk-ant-...
node dist/cli.js run examples/btc-eth.json --once
node dist/cli.js verify journal/tidewatcher.jsonl
Paper mode uses real Hyperliquid prices with simulated fills, the 0.045% taker fee and isolated liquidation. Going live needs HL_PRIVATE_KEY (a Hyperliquid API wallet, which can trade but not withdraw), HL_ACCOUNT_ADDRESS, and both --live --i-understand-real-funds. Try "testnet": true first.
Features
| Hard limits | Allowed markets, max leverage clamped to the live exchange cap (BTC 40x, ETH 25x today), margin per trade, open positions, daily-loss kill switch |
| Journal | SHA-256 chained JSONL. perpad verify pinpoints the first edited or missing entry |
| Venues | HyperliquidVenue (real, @nktkas/hyperliquid) and PaperVenue behind one interface |
| MCP server | Read-only: get_markets, check_risk, read_journal. Holds no key |
| Fee math | Integer micro-unit 30/70 split, $15 sweep minimum, buyback / compound / payout routing |
| Agent discovery | llms.txt, llms-full.txt, A2A agent card, MCP metadata, AGENTS.md |
Library
import { Agent, Journal, PaperVenue, HyperliquidPrices } from "perpad";
const venue = new PaperVenue(new HyperliquidPrices(), 1000);
await new Agent(config, venue, new Journal("journal/a.jsonl")).tick();
import { evaluate } from "perpad";
evaluate(
{ coin: "BTC", side: "long", leverage: 100, marginUsd: 900 },
{ openCoins: [], withdrawableUsd: 1000, dailyPnlUsd: 0, exchangeMaxLeverage: { BTC: 40 } },
{ markets: ["BTC"], maxLeverage: 50, marginPerTradeUsd: 100, maxOpenPositions: 1 },
); // { allowed: true, adjusted: { leverage: 40, marginUsd: 100 } }
MCP
{ "mcpServers": { "perpad": { "command": "npx", "args": ["-y", "github:nirholas/perpad", "mcp", "journal/agent.jsonl"] } } }
Status and roadmap
v0.1 ships the trading core, journal, paper and live venues, MCP server and fee math, covered by 21 tests including a live Hyperliquid read. The Solana leg (claim pump.fun creator fees, swap, bridge, deposit to Hyperliquid), coin launch flow, buybacks and journal anchoring are on the roadmap. They are not shipped and nothing here pretends otherwise.
Security and risk
Leveraged perps can lose all margin quickly. This is software, not financial advice, and makes no profit claims. Read the security model and SECURITY.md. Independent project, not affiliated with Hyperliquid, pump.fun or Anthropic.
Contributing
PRs welcome. See CONTRIBUTING.md. Questions and ideas go to Discussions.
Development
npm test # 21 tests, includes a live read-only Hyperliquid call
npm run typecheck
npm run site:build # regenerates docs/ (GitHub Pages)
MIT © nirholas
Support the project
If perpad saves you time, star it on GitHub. Stars are how other developers and AI agents find the repositories worth trusting, and they cost you one click.
Know someone who would use it? Post on X · Share on Bluesky · Share on LinkedIn · Submit to Hacker News · Share on Reddit
Built for AI agents too
Coding agents and LLM tooling can read this repo directly: AGENTS.md, llms.txt, llms-full.txt. Point an agent at https://github.com/nirholas/perpad and it has the context it needs.
More from the same author
- All repositories by nirholas: the full catalog, grouped by topic
- three.ws: the platform for 3D AI agents with Solana wallets, a skill marketplace and x402 payments
- Questions or ideas: open an issue or start a discussion
Contributors
Star history
Pertanyaan tentang perpad MCP
Apakah AI agent bisa melewati batas risiko?
Tidak, model beroperasi dalam batasan ketat yang ditegakkan oleh risk engine deterministik yang tidak bisa dilewati oleh model tersebut.
Bagaimana cara mengetes trading agent tanpa menggunakan dana asli?
Anda bisa menggunakan paper mode, yang menggunakan harga real Hyperliquid dengan simulasi fills, taker fees, dan likuidasi terisolasi.
Apa kegunaan dari journal?
Journal adalah file JSONL dengan SHA-256 hash-chained yang mencatat setiap thought, action, dan refusal untuk keperluan verifikasi.
Apakah MCP server ini mampu mengeksekusi trade?
MCP server ini bersifat read-only dan tidak menyimpan key apa pun, hanya menyediakan tools untuk mengambil data market, mengecek risiko, dan membaca journal.