perpad MCP sunucusu
Commit 13 Kas 2026AI agent'larının Hyperliquid üzerinde, deterministik risk denetimi ve değiştirilemez bir günlük (journal) eşliğinde otonom sürekli vadeli işlem (perpetual trading) yapmasını sağlar.
Ayrıca bilinen adı nirholas/perpad
- Yıldızlar
- 4
- Araçlar
- —
- İndirmeler, 30 gün
- —
- En son sürüm
- —
- Son commit
- 13 Kas 2026
- Lisans
- MIT
perpad MCP nedir?
AI agent'larının Hyperliquid üzerinde, deterministik risk denetimi ve değiştirilemez bir günlük (journal) eşliğinde otonom sürekli vadeli işlem (perpetual trading) yapmasını sağlar.
Özet, projenin README dosyasından oluşturuldu
perpad MCP sunucusu hakkında
perpad, AI trading agent'ları geliştiren yazılımcıların Hyperliquid üzerinde sıkı güvenlik bariyerleri ile otonom sürekli vadeli işlemler gerçekleştirmesine olanak tanır. Yalnızca model talimatlarına dayanan standart uygulamaların aksine bu sistem, bir LLM'in aşamayacağı limitleri uygulamak için saf kodla yazılmış deterministik bir risk motoru kullanır. BTC ve ETH gibi varlıklar için izole marjinli perpetual işlemleri yönetirken her eylemin önceden tanımlanmış kısıtlamalara uymasını sağlar.
sağlar. Kullanıcılar bunu simüle edilmiş işlemler ve gerçek fiyatlar kullanarak paper mode ile devreye alabilir veya bir Hyperliquid API cüzdan anahtarı ve hesap adresi sağlayarak canlıya geçebilirler. Kurulum için agent mantığı adına bir Anthropic API anahtarı gereklidir. Hesap verebilirliği sağlamak için sunucu, her düşünceyi, eylemi ve reddetme işlemini JSONL formatında kaydeden SHA-256 hash-chained bir günlük tutar. Bu, perpad verify komutu aracılığıyla agent'ın karar verme geçmişinin kolayca doğrulanmasına olanak tanır.
Neler yapabilirsiniz
- 1Ticaret stratejilerini güvenli bir şekilde simüle edinGerçek sermaye riske atmadan, gerçek piyasa fiyatlarını ve simüle edilmiş ücretleri kullanarak otonom ticaret mantığını test edin.
- 2Agent karar geçmişini denetleyinHerhangi bir kaydın değiştirilmediğinden emin olmak için bir agent'ın ticaret günlüklerinin bütünlüğünü doğrulayın.
- 3MCP aracılığıyla piyasa verilerini izleyinBir AI istemcisinin mevcut piyasaları incelemesine ve güncel risk durumunu kontrol etmesine izin vermek için MCP server kullanın.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
Yapılandırma
ANTHROPIC_API_KEY
| Ad | Açıklama | Sunucu |
|---|---|---|
| ANTHROPIC_API_KEY | — |
Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Henüz doğrulanmadı. Bir sunucunun 80 puana, ciddi bir bulgu olmamasına ve kontrol edebilmemiz için yeterli veriye ihtiyacı vardır. Kontroller nasıl çalışır · Daha fazla puan için nelerin düzeltileceği
- Kaynak deposu bağlantılı ve erişilebilirnirholas/perpad is public and reachablegithub.com/nirholas/perpad ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyorKontrol edilmedi
- Derleme kökeni (Sigstore onayı)Kontrol edilmedi
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-11-13github.com/nirholas/perpad ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilKontrol edilmedi
- Pakette veya bağımlılıklarında kritik uyarı yokKontrol edilmedi
- Modele yönelik gizli talimat yok0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
perpad
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
perpad MCP soruları
AI agent risk limitlerini aşabilir mi?
Hayır, model, kendisinin baypas edemeyeceği deterministik bir risk motoru tarafından uygulanan katı limitler dahilinde çalışır.
Gerçek fon kullanmadan işlem agent'ını nasıl test edebilirim?
Gerçek Hyperliquid fiyatlarını simüle edilmiş işlemler, taker ücretleri ve izole likidasyon ile kullanan paper mode'u kullanabilirsiniz.
Günlüğün (journal) amacı nedir?
Günlük, doğrulama amacıyla her düşünceyi, eylemi ve reddetme işlemini kaydeden, SHA-256 hash-chained yapısında bir JSONL dosyasıdır.
MCP server işlem gerçekleştirebilir mi?
MCP server salt okunurdur ve herhangi bir anahtar barındırmaz; piyasaları çekmek, riski kontrol etmek ve günlüğü okumak için araçlar sağlar.