MCP server perpad
Коммит 13 нояб. 2026 г.Позволяет ИИ-агентам осуществлять автономную бессрочную торговлю на Hyperliquid с детерминированным контролем рисков и защищенным от подделок журналом событий.
Также известен как nirholas/perpad
- Звёзды
- 4
- Инструменты
- —
- Загрузки, 30 дней
- —
- Последняя версия
- —
- Последний коммит
- 13 нояб. 2026 г.
- Лицензия
- MIT
Что такое perpad MCP?
Позволяет ИИ-агентам осуществлять автономную бессрочную торговлю на Hyperliquid с детерминированным контролем рисков и защищенным от подделок журналом событий.
Сводка сгенерирована из README проекта
О perpad MCP server
perpad позволяет разработчикам, создающим торговых ИИ-агентов, выполнять автономные бессрочные сделки на Hyperliquid со строгими защитными механизмами. В отличие от стандартных реализаций, полагающихся исключительно на инструкции модели, эта система использует детерминированный движок рисков, написанный на чистом коде, для соблюдения ограничений, которые LLM не может обойти. Система управляет бессрочными контрактами с изолированной маржой для таких активов, как BTC и ETH, гарантируя, что каждое действие соответствует заданным параметрам.
Пользователи могут развернуть систему в paper mode, используя симуляцию исполнения и реальные цены, или перейти к реальной торговле, предоставив API ключ кошелька Hyperliquid и адрес аккаунта. Для работы агентской логики требуется Anthropic API key. Чтобы обеспечить подотчетность, сервер ведет журнал с цепочкой хешей SHA-256, который записывает каждую мысль, действие и отказ в формате JSONL. Это позволяет легко проверять историю принятия решений агентом с помощью команды perpad verify.
Что вы можете с ним делать
- 1Безопасное тестирование торговых стратегийТестируйте логику автономной торговли, используя реальные рыночные цены и симулированные комиссии, не рискуя реальным капиталом.
- 2Аудит истории решений агентаПроверяйте целостность торговых логов агента, чтобы убедиться, что в записи не вносились изменения.
- 3Мониторинг рыночных данных через MCPИспользуйте MCP server, чтобы позволить ИИ-клиенту анализировать доступные рынки и проверять текущий статус рисков.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Конфигурация
ANTHROPIC_API_KEY
| Название | Описание | Тип |
|---|---|---|
| ANTHROPIC_API_KEY | — |
Автоматические проверки
Запущено 14 нояб. 2026 г.Полный отчёт →Еще не проверено. Для сервера требуется оценка 80, отсутствие серьезных проблем и достаточно данных для нашей проверки. Как работают проверки · Что исправить, чтобы получить больше баллов
- Связанный и доступный исходный репозиторийnirholas/perpad is public and reachablegithub.com/nirholas/perpad ↗Пройдено
- Пакет указывает этот репозиторий как источникНе проверялось
- Происхождение сборки (аттестация Sigstore)Не проверялось
- Open source лицензия (OSI)MITspdx.org/licenses/MIT.html ↗Пройдено
- Коммит или релиз за последний год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
Открыть на 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
Вопросы о perpad MCP
Может ли ИИ-агент обойти лимиты риска?
Нет, модель работает в рамках жестких ограничений, установленных детерминированным движком рисков, который модель не может обойти.
Как протестировать торгового агента без использования реальных средств?
Вы можете использовать paper mode, который использует реальные цены Hyperliquid с симуляцией исполнения ордеров, комиссий тейкера и изолированной ликвидацией.
Для чего нужен журнал?
Журнал представляет собой JSONL-файл с цепочкой хешей SHA-256, который записывает каждую мысль, действие и отказ для последующей проверки.
Может ли MCP server исполнять сделки?
MCP server работает в режиме только для чтения и не хранит ключи; он предоставляет инструменты для получения данных о рынках, проверки рисков и чтения журнала.