{
  "markdown": "# hyperliquid-mcp\n\n**Give your AI agent eyes on Hyperliquid.** A tiny, read-only [MCP](https://modelcontextprotocol.io) server that lets Claude (or any MCP-compatible agent) query Hyperliquid perp markets, funding rates, order books, candles — and the positions, fills and funding of **any** address.\n\n- 🔑 **No API keys, no wallets, no signing** — only the public Info API. It cannot trade, ever.\n- 📦 **Zero config** — one entry in your MCP config and you're done.\n- 🪶 **Tiny** — two source files, two dependencies (MCP SDK + zod).\n\n## Quick start\n\n### Claude Code\n\n```bash\nclaude mcp add hyperliquid -- npx -y @kitsune-de/hyperliquid-mcp\n```\n\n### Claude Desktop / Cursor / any MCP client\n\n```json\n{\n  \"mcpServers\": {\n    \"hyperliquid\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@kitsune-de/hyperliquid-mcp\"]\n    }\n  }\n}\n```\n\n### From source\n\n```bash\ngit clone https://github.com/kitsune-de/hyperliquid-mcp\ncd hyperliquid-mcp && npm install && npm run build\n# then point your MCP client at: node /path/to/hyperliquid-mcp/dist/index.js\n```\n\n## What you can ask\n\n> *\"What are the most extreme funding rates on Hyperliquid right now?\"*\n>\n> *\"Show the open positions and liquidation prices of 0xabc… — how close is it to liquidation?\"*\n>\n> *\"How much funding did my account pay over the last week, per coin?\"*\n>\n> *\"Pull 4h candles for HYPE and describe the trend.\"*\n\n## Tools\n\n| Tool | Arguments | Returns |\n| --- | --- | --- |\n| `get_markets` | `coin?`, `sortBy?` (volume · funding · change · openInterest), `limit?` | Perp markets: mark price, 24h change & volume, open interest, funding (1h + annualized APR), max leverage |\n| `get_price` | `coins?` | Mid prices for given coins, or all perp mids |\n| `get_orderbook` | `coin`, `depth?` | L2 snapshot: best bid/ask, spread %, levels per side |\n| `get_candles` | `coin`, `interval?`, `count?` | OHLCV candles (1m … 1w) |\n| `get_account` | `address` | Account value, margin usage, withdrawable, every perp position (side, size, entry, liq price, uPnL, leverage), spot balances |\n| `get_open_orders` | `address` | Resting orders: side, price, size, type, trigger info |\n| `get_recent_fills` | `address`, `limit?` | Recent fills: direction, price, size, notional, closed PnL, fees |\n| `get_funding_paid` | `address`, `hours?` | Net funding paid/received per coin over a window |\n\nAll account tools work on **any** address — your own, a whale's, a vault's. It's all public on-chain data.\n\n## Configuration\n\n| Env var | Default | Purpose |\n| --- | --- | --- |\n| `HL_INFO_URL` | `https://api.hyperliquid.xyz/info` | Set to `https://api.hyperliquid-testnet.xyz/info` for testnet |\n\n## Development\n\n```bash\nnpm install\nnpm run build\nnpm run smoke   # spawns the server over stdio and exercises every tool against live mainnet\n```\n\n## Disclaimer\n\nRead-only market data tooling. Not financial advice; no affiliation with Hyperliquid.\n\n## License\n\nMIT\n",
  "bytes": 2898,
  "sha": "daf3a4a7db0f15fd862456c9ace0ea84fafa662a2be875d2a66195343cedc4a9",
  "repo_slug": "kitsune-de/hyperliquid-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_kitsune_de_hyperliquid_mcp_a1e72535/readme"
}