io.github.Glebenjoy/hyperliquid-info-mcp
Hyperliquid perp & spot data: prices, funding, open interest, order book, positions. No API key.
Open source Open in the app JSON README (API)
About
Hyperliquid perp & spot data: prices, funding, open interest, order book, positions. No API key.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- glebenjoy
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.0.0
- Last push
- 2026-06-06T19:23:24Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-08-29 03:01:56
- Updated
- 2026-08-29 03:01:56
- Origin id
io.github.Glebenjoy/hyperliquid-info-mcp
README
# Hyperliquid Info MCP
An [MCP](https://modelcontextprotocol.io) server that gives Claude, Cursor, and any
MCP-compatible agent **live market and account data from [Hyperliquid](https://hyperliquid.xyz)** —
perp and spot prices, funding rates, open interest, order books, and wallet positions.
No API key. No signup. The public Hyperliquid info API is free.
> Most "MCP for X" repos are half-finished and break on the second request. This one ships
> with tests and graceful error handling so an agent can actually rely on it.
## What your agent can do
Ask things like:
- "What are the top Hyperliquid perps by 24h volume right now?"
- "Show me BTC perp: mark price, funding, and open interest."
- "Which perps have the highest funding rates?" (carry / basis hunting)
- "What's the BTC order book and spread?"
- "How has ETH funding moved over the last 48 hours?"
- "Biggest gainers and losers on Hyperliquid spot today?"
- "Show the open positions and PnL for wallet 0xabc..."
## Tools
| Tool | What it does |
|------|--------------|
| `get_all_mids` | Current mid prices for all markets, optionally filtered to specific coins |
| `get_perp_markets` | All perps ranked by volume / OI / funding / change / gainers / losers |
| `get_market` | Deep snapshot of one perp: mark/oracle/mid, 24h change & vol, funding, OI, premium, leverage |
| `get_funding_history` | Funding-rate history for a perp over an N-hour window, with the average |
| `get_order_book` | Live L2 book (top bids/asks + spread) for a perp or spot pair |
| `get_spot_markets` | Spot markets (HYPE, PURR, etc.) ranked by volume / change |
| `get_user_state` | Perp account state for any wallet: value, margin, and open positions with PnL & liq price |
## Install
No install needed. It runs straight from npm via `npx`.
### Claude Desktop
Add to `claude_desktop_config.json`:
```json
{
"mcpServers": {
"hyperliquid": {
"command": "npx",
"args": ["-y", "hyperliquid-info-mcp"]
}
}
}
```
### Cursor
Add to `.cursor/mcp.json`:
```json
{
"mcpServers": {
"hyperliquid": {
"command": "npx",
"args": ["-y", "hyperliquid-info-mcp"]
}
}
}
```
Restart the client and the `hyperliquid` tools appear.
## Notes
- All data is **read-only** market/account info from the public `https://api.hyperliquid.xyz/info`
endpoint. This server places no orders and never needs a private key.
- Funding is shown both per-hour (how Hyperliquid charges it) and annualized, which is what
traders actually compare.
- `get_user_state` works for any public wallet address — it reads the same data the explorer shows.
## Develop
```bash
npm install
npm run dev # run from TypeScript source over stdio
npm test # run the unit tests
npm run build # compile to dist/
```
## License
MIT — see [LICENSE](./LICENSE).
---
## Hire me
I build custom MCP servers and AI systems (multi-agent, RAG, automation). Need a connector for your own API, or a full AI integration?
- Hire me on Upwork: https://www.upwork.com/freelancers/~01946645ed245c263d
- Or open an issue on this repo.
Built by Gleb.