Server data from the Official MCP Registry
Read-only Hyperliquid data: markets, funding rates, order books, candles, positions and fills
About
Read-only Hyperliquid data: markets, funding rates, order books, candles, positions and fills
Security Report
Excellent security posture. This is a well-designed read-only MCP server for querying public Hyperliquid market data and blockchain state. Authentication is not required by design (the Info API is public), permissions are narrowly scoped to network HTTP calls only, and the codebase demonstrates strong input validation, error handling, and no dangerous patterns. Code quality is high with proper TypeScript typing and validation via Zod. Supply chain analysis found 3 known vulnerabilities in dependencies (0 critical, 3 high severity). Package verification found 1 issue.
5 files analyzed · 7 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Environment variable: HL_INFO_URL
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-kitsune-de-hyperliquid-mcp": {
"env": {
"HL_INFO_URL": "your-hl-info-url-here"
},
"args": [
"-y",
"@kitsune-de/hyperliquid-mcp"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
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-mcp
Claude 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.js
What 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
| Tool | Arguments | Returns |
|---|---|---|
get_markets | coin?, sortBy? (volume · funding · change · openInterest), limit? | Perp markets: mark price, 24h change & volume, open interest, funding (1h + annualized APR), max leverage |
get_price | coins? | Mid prices for given coins, or all perp mids |
get_orderbook | coin, depth? | L2 snapshot: best bid/ask, spread %, levels per side |
get_candles | coin, interval?, count? | OHLCV candles (1m … 1w) |
get_account | address | Account value, margin usage, withdrawable, every perp position (side, size, entry, liq price, uPnL, leverage), spot balances |
get_open_orders | address | Resting orders: side, price, size, type, trigger info |
get_recent_fills | address, limit? | Recent fills: direction, price, size, notional, closed PnL, fees |
get_funding_paid | address, hours? | Net funding paid/received per coin over a window |
All account tools work on any address — your own, a whale's, a vault's. It's all public on-chain data.
Configuration
| Env var | Default | Purpose |
|---|---|---|
HL_INFO_URL | https://api.hyperliquid.xyz/info | Set to https://api.hyperliquid-testnet.xyz/info for testnet |
Development
npm install
npm run build
npm run smoke # spawns the server over stdio and exercises every tool against live mainnet
Disclaimer
Read-only market data tooling. Not financial advice; no affiliation with Hyperliquid.
License
MIT
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Fetch
Freeby Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption