perpad MCP server
2026년 11월 13일 커밋결정론적 리스크 관리와 위변조 방지 저널을 통해 AI 에이전트가 Hyperliquid에서 자율적인 무기한 선물 거래를 수행할 수 있도록 지원합니다.
다른 이름 nirholas/perpad
- 스타
- 4
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- —
- 마지막 커밋
- 2026년 11월 13일
- 라이선스
- MIT
perpad MCP란?
결정론적 리스크 관리와 위변조 방지 저널을 통해 AI 에이전트가 Hyperliquid에서 자율적인 무기한 선물 거래를 수행할 수 있도록 지원합니다.
프로젝트 README에서 생성된 요약
perpad MCP server 정보
perpad는 AI 트레이딩 에이전트를 구축하는 개발자가 엄격한 안전 가드레일을 갖춘 상태에서 Hyperliquid의 자율 무기한 선물 거래를 실행할 수 있도록 지원합니다. 모델의 지시 사항에만 의존하는 일반적인 구현과 달리, 이 시스템은 LLM이 우회할 수 없는 제한 사항을 강제하기 위해 순수 코드로 작성된 결정론적 리스크 엔진을 사용합니다. BTC 및 ETH와 같은 자산에 대한 격리 마진 무기한 선물을 관리하며, 모든 행동이 사전 정의된 제약 조건을 따르도록 보장합니다.
사용자는 시뮬레이션된 체결과 실제 가격을 사용하는 페이퍼 모드로 배포하거나, Hyperliquid API 지갑 키와 계정 주소를 제공하여 실거래를 시작할 수 있습니다. 설정 시 에이전트 로직을 위한 Anthropic API 키가 필요합니다. 책임성을 보장하기 위해 서버는 모든 사고, 행동, 거절을 JSONL 형식으로 기록하는 SHA-256 해시 체인 저널을 유지합니다. 이를 통해 perpad verify 명령어로 에이전트의 의사 결정 이력을 쉽게 검증할 수 있습니다.
활용 사례
- 1트레이딩 전략의 안전한 시뮬레이션실제 자본을 위험에 노출시키지 않고 실제 시장 가격과 시뮬레이션된 수수료를 사용하여 자율 트레이딩 로직을 테스트합니다.
- 2에이전트 의사 결정 이력 감사에이전트의 트레이딩 로그 무결성을 검증하여 데이터 조작 여부를 확인합니다.
- 3MCP를 통한 시장 데이터 모니터링MCP server를 사용하여 AI 클라이언트가 사용 가능한 시장을 조사하고 현재 리스크 상태를 확인할 수 있도록 합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
구성
ANTHROPIC_API_KEY
| 이름 | 설명 | 유형 |
|---|---|---|
| ANTHROPIC_API_KEY | — |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능nirholas/perpad is public and reachablegithub.com/nirholas/perpad ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-13github.com/nirholas/perpad ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기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 질문
AI 에이전트가 리스크 제한을 무시할 수 있나요?
아니요, 모델은 모델이 우회할 수 없는 결정론적 리스크 엔진에 의해 강제되는 엄격한 제한 내에서만 작동합니다.
실제 자금을 사용하지 않고 트레이딩 에이전트를 테스트할 수 있나요?
실제 Hyperliquid 가격을 사용하되 체결, 테이커 수수료, 격리 청산을 시뮬레이션하는 페이퍼 모드를 사용할 수 있습니다.
저널의 용도는 무엇인가요?
저널은 모든 사고, 행동, 거절 기록을 검증할 수 있도록 SHA-256 해시 체인으로 연결된 JSONL 파일입니다.
MCP server가 직접 거래를 실행할 수 있나요?
MCP server는 읽기 전용이며 키를 보유하지 않습니다. 시장 정보 조회, 리스크 확인, 저널 읽기 등의 도구를 제공합니다.