MCP server de perpad
Commit 13 nov 2026Permite que los agentes de IA ejecuten trading perpetuo autónomo en Hyperliquid con cumplimiento de riesgo determinista y un diario a prueba de manipulaciones.
También conocido como nirholas/perpad
- Stars
- 4
- Herramientas
- —
- Descargas, 30 días
- —
- Última versión
- —
- Último commit
- 13 nov 2026
- Licencia
- MIT
¿Qué es perpad MCP?
Permite que los agentes de IA ejecuten trading perpetuo autónomo en Hyperliquid con cumplimiento de riesgo determinista y un diario a prueba de manipulaciones.
Resumen generado a partir del README del proyecto
Acerca del MCP server de perpad
Ejecutar operaciones perpetuas autónomas en Hyperliquid con estrictas salvaguardas de seguridad es lo que perpad permite a los desarrolladores que construyen agentes de trading con IA. A diferencia de las implementaciones estándar que dependen únicamente de las instrucciones del modelo, este sistema utiliza un motor de riesgo determinista escrito en código puro para imponer límites que un LLM no puede ignorar. Gestiona perps de margen aislado para activos como BTC y ETH, asegurando que cada acción siga las restricciones predefinidas.
Los usuarios pueden implementar esto en modo paper usando ejecuciones simuladas y precios reales, o pasar a producción proporcionando una llave de wallet de la API de Hyperliquid y la dirección de la cuenta. La configuración requiere una API key de Anthropic para la lógica agéntica. Para garantizar la rendición de cuentas, el servidor mantiene un diario con cadena de hashes SHA-256 que registra cada pensamiento, acción y negativa en formato JSONL. Esto permite una verificación sencilla del historial de toma de decisiones del agente mediante el comando perpad verify.
Qué puedes hacer con él
- 1Simular estrategias de trading de forma seguraPrueba la lógica de trading autónomo utilizando precios de mercado reales y comisiones simuladas sin arriesgar capital real.
- 2Auditar el historial de decisiones del agenteVerifica la integridad de los registros de trading de un agente para asegurar que ninguna entrada haya sido manipulada.
- 3Monitorear datos de mercado vía MCPUtiliza el MCP server para permitir que un cliente de IA inspeccione los mercados disponibles y verifique el estado de riesgo actual.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Configuración
ANTHROPIC_API_KEY
| Nombre | Descripción | Tipo |
|---|---|---|
| ANTHROPIC_API_KEY | — |
Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Aún no verificado. Un servidor necesita una puntuación de 80, ningún hallazgo grave y suficientes datos para que podamos revisarlo. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesiblenirholas/perpad is public and reachablegithub.com/nirholas/perpad ↗Aprobado
- El paquete indica este repositorio como su origenNo verificado
- Procedencia de la compilación (atestación de Sigstore)No verificado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-11-13github.com/nirholas/perpad ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo verificado
- No hay avisos críticos en el paquete ni en sus dependenciasNo verificado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPNo verificado
README
Ver en 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
Preguntas sobre perpad MCP
¿Puede el agente de IA ignorar los límites de riesgo?
No, el modelo opera dentro de límites estrictos aplicados por un motor de riesgo determinista que el modelo no puede eludir.
¿Cómo puedo probar el agente de trading sin usar fondos reales?
Puedes usar el modo paper, que utiliza precios reales de Hyperliquid con ejecuciones simuladas, comisiones de taker y liquidación aislada.
¿Cuál es el propósito del diario?
El diario es un archivo JSONL con una cadena de hashes SHA-256 que registra cada pensamiento, acción y negativa para su verificación.
¿Es el MCP server capaz de ejecutar operaciones?
El MCP server es de solo lectura y no contiene llaves; proporciona herramientas para obtener mercados, verificar riesgos y leer el diario.