Serveur MCP perpad
Commit 13 nov. 2026Permet aux agents IA d'exécuter du trading perpétuel autonome sur Hyperliquid avec une application déterministe des risques et un journal infalsifiable.
Aussi connu sous nirholas/perpad
- Étoiles
- 4
- Outils
- —
- Téléchargements, 30 jours
- —
- Dernière version
- —
- Dernier commit
- 13 nov. 2026
- Licence
- MIT
Qu'est-ce que perpad MCP ?
Permet aux agents IA d'exécuter du trading perpétuel autonome sur Hyperliquid avec une application déterministe des risques et un journal infalsifiable.
Résumé généré à partir du README du projet
À propos du MCP server perpad
Exécuter des transactions perpétuelles autonomes sur Hyperliquid avec des garde-fous de sécurité stricts est ce que perpad permet aux développeurs qui construisent des agents de trading IA. Contrairement aux implémentations standards qui reposent uniquement sur les instructions du modèle, ce système utilise un moteur de risque déterministe écrit en code pur pour imposer des limites qu'un LLM ne peut pas outrepasser. Il gère les perps en marge isolée pour des actifs comme BTC et ETH tout en garantissant que chaque action respecte des contraintes prédéfinies.
Les utilisateurs peuvent déployer cela en mode paper en utilisant des exécutions simulées et des prix réels, ou passer en live en fournissant une clé de portefeuille API Hyperliquid et une adresse de compte. La configuration nécessite une clé API Anthropic pour la logique agentique. Pour garantir la responsabilité, le serveur maintient un journal chaîné par hachage SHA-256 qui enregistre chaque pensée, action et refus au format JSONL. Cela permet une vérification facile de l'historique de prise de décision de l'agent via la commande perpad verify.
Ce que vous pouvez faire avec
- 1Simuler des stratégies de trading en toute sécuritéTestez votre logique de trading autonome en utilisant les prix réels du marché et des frais simulés sans risquer de capital réel.
- 2Auditer l'historique de décision de l'agentVérifiez l'intégrité des journaux de trading d'un agent pour vous assurer qu'aucune entrée n'a été falsifiée.
- 3Surveiller les données du marché via MCPUtilisez le MCP server pour permettre à un client IA d'inspecter les marchés disponibles et de vérifier l'état actuel des risques.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Configuration
ANTHROPIC_API_KEY
| Nom | Description | Type |
|---|---|---|
| ANTHROPIC_API_KEY | — |
Vérifications automatisées
Exécuté le 14 nov. 2026Rapport complet →Pas encore vérifié. Un serveur nécessite un score de 80, aucune faille sérieuse et suffisamment de données pour que nous puissions effectuer les vérifications. Fonctionnement des vérifications · Ce qu'il faut corriger pour gagner des points
- Dépôt source lié et accessiblenirholas/perpad is public and reachablegithub.com/nirholas/perpad ↗Réussi
- Le nom du package correspond au dépôt sourceNon vérifié
- Provenance du build (attestation Sigstore)Non vérifié
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-11-13github.com/nirholas/perpad ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNon vérifié
- Aucun avis critique dans le package ou ses dépendancesNon vérifié
- Aucune instruction cachée destinée au modèle0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNon vérifié
- Le point de terminaison distant répond à la poignée de main MCPNon vérifié
README
Voir sur 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
Questions sur perpad MCP
L'agent IA peut-il outrepasser les limites de risque ?
Non, le modèle opère dans des limites strictes imposées par un moteur de risque déterministe que le modèle ne peut pas contourner.
Comment puis-je tester l'agent de trading sans utiliser de fonds réels ?
Vous pouvez utiliser le mode paper, qui utilise les prix réels de Hyperliquid avec des exécutions simulées, des frais de taker et des liquidations isolées.
Quel est l'objectif du journal ?
Le journal est un fichier JSONL chaîné par hachage SHA-256 qui enregistre chaque pensée, action et refus à des fins de vérification.
Le MCP server est-il capable d'exécuter des transactions ?
Le MCP server est en lecture seule et ne détient aucune clé ; il fournit des outils pour obtenir les marchés, vérifier les risques et lire le journal.