perpad MCPサーバー
コミット 2026年11月13日Hyperliquid上での自律的なパーペチュアル取引を、決定論的なリスク管理と改ざん防止機能付きのジャーナルによってAIエージェントに実現させます。
別名 nirholas/perpad
- スター
- 4
- ツール
- —
- ダウンロード数(30日間)
- —
- 最新バージョン
- —
- 最終コミット
- 2026年11月13日
- ライセンス
- MIT
perpad MCPとは
Hyperliquid上での自律的なパーペチュアル取引を、決定論的なリスク管理と改ざん防止機能付きのジャーナルによってAIエージェントに実現させます。
プロジェクトの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は読み取り専用であり、キーも保持しません。マーケット情報の取得、リスクチェック、ジャーナルの読み取りを行うためのツールを提供します。