Hyperliquid MCP server
io.github.kitsune-de/hyperliquid-mcp·v0.1.0·1 starsRead-only Hyperliquid data: markets, funding rates, order books, candles, positions and fills
1 stars29 downloads/wk
Reviews
Write oneNobody has reviewed Hyperliquid yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Hyperliquid tools (8)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
get_accountFull account state for any Hyperliquid address: account value, margin usage, withdrawable, every open perp position
get_candlesHistorical OHLCV candles for a perp market. Intervals: ….
get_funding_paidNet funding paid or received by an address over the last N hours, broken down by coin. Positive = received, negative = paid.
get_marketsList Hyperliquid perpetual markets with mark price, 24h change, 24h volume, open interest, funding rate (1h and annualized APR) and max leverage.
get_open_ordersResting open orders for an address: side, price, size, order type, trigger info.
get_orderbookL2 order book snapshot for a perp market: best bid/ask, spread, and aggregated levels per side.
get_priceCurrent mid prices. Pass `coins` for specific perp markets (e.g. ["BTC", "ETH"]) or omit to get all perp mids at once.
get_recent_fillsMost recent trade fills for an address: direction (Open Long / Close Short / ...), price, size, notional, closed PnL and fees.
Public scan report
scanner v0.1.9 · 2026-09-25 · same rubric, same numbers if you re-run it
- Code scan4 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 70 days ago12/15
- Maintainer identityregistry namespace matches repository owner6/10
How Hyperliquid compares
Against every graded E-commerce MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 85/100
- higher than 80% of 2,174 E-commerce servers
- Tools
- 8
- the typical E-commerce server has 6
- Tools that change things
- 0%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 1
- more than 65% of 1,047 E-commerce servers
- Downloads a week
- 29
- more than 20% of 411 E-commerce servers with a package
What its tools let an agent do: 8 read
Install Hyperliquid in Claude Code, Cursor or VS Code
Runs npx -y @kitsune-de/hyperliquid-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add hyperliquid-mcp -- npx -y @kitsune-de/hyperliquid-mcp
What the publisher says
From the Hyperliquid repository's README, as published. We do not edit it. Read it on GitHub
hyperliquid-mcp
Give your AI agent eyes on Hyperliquid. A tiny, read-only MCP 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.
- 🔑 No API keys, no wallets, no signing — only the public Info API. It cannot trade, ever.
- 📦 Zero config — one entry in your MCP config and you're done.
- 🪶 Tiny — two source files, two dependencies (MCP SDK + zod).
Quick start
Claude Code
claude mcp add hyperliquid -- npx -y @kitsune-de/hyperliquid-mcpClaude Desktop / Cursor / any MCP client
{
"mcpServers": {
"hyperliquid": {
"command": "npx",
"args": ["-y", "@kitsune-de/hyperliquid-mcp"]
}
}
}From source
git clone https://github.com/kitsune-de/hyperliquid-mcp
cd hyperliquid-mcp && npm install && npm run build
# then point your MCP client at: node /path/to/hyperliquid-mcp/dist/index.jsWhat you can ask
"What are the most extreme funding rates on Hyperliquid right now?"
"Show the open positions and liquidation prices of 0xabc… — how close is it to liquidation?"
"How much funding did my account pay over the last week, per coin?"
"Pull 4h candles for HYPE and describe the trend."
Tools
All account tools work on any address — your own, a whale's, a vault's. It's all public on-chain data.
Configuration
Development
npm install
npm run build
npm run smoke # spawns the server over stdio and exercises every tool against live mainnetDisclaimer
Read-only market data tooling. Not financial advice; no affiliation with Hyperliquid.
License
MIT
Nothing above is checked by us. What we check is on the safety report.
Hyperliquid: common questions
- Is Hyperliquid MCP server safe?
- Yes, by our scan: it is graded A (85/100). Read the Hyperliquid safety report
- How do I install Hyperliquid?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Hyperliquid need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Hyperliquid maintained?
- The last commit was 109 days ago (2026-07-18). The latest release is v0.1.0.
- What can I use instead of Hyperliquid?
- Servers from other publishers that do the same job: Iran Crypto Exchanges MCP server, Polymarket Toolkit MCP server and Polymarket Paper Trader MCP server.
- How does Hyperliquid compare with other E-commerce MCP servers?
- safety score 85/100 (higher than 80% of 2,174 E-commerce servers); tools 8 (the typical E-commerce server has 6); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Hyperliquid
Same job from other publishers: the closest match first, then the best rated.
- Iran Crypto ExchangesUnofficial read-only Iranian crypto exchanges: prices in Toman, order books, trades, candles.not reviewedGrowingA
- Polymarket ToolkitRead-only Polymarket data tools for AI agents: profiles, PnL, market scans. No keys, no orders.not reviewedEstablishedB
- Polymarket Paper TraderPolymarket paper trading for AI agents: $10k paper money, real order books, official fees.not reviewedGrowingA
LongbridgeUS/HK markets — 163 tools: quotes, options, orders, fundamentals, screener, IPO, alerts, DCA & gridnot reviewedGrowingA- OmieMCP server for Omie — ERP, customers, products, orders, invoices, financialsnot reviewedEstablishedB