# Hyperliquid Mcp

> Read-only MCP server for Hyperliquid: markets, funding rates, order books, candles, positions & fills for AI agents

- **Type:** MCP server
- **Install:** `agentstack add mcp-kitsune-de-hyperliquid-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [kitsune-de](https://agentstack.voostack.com/s/kitsune-de)
- **Installs:** 0
- **Category:** [Finance & Payments](https://agentstack.voostack.com/c/finance-and-payments)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [kitsune-de](https://github.com/kitsune-de)
- **Source:** https://github.com/kitsune-de/hyperliquid-mcp

## Install

```sh
agentstack add mcp-kitsune-de-hyperliquid-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# hyperliquid-mcp

**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.

- 🔑 **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

```bash
claude mcp add hyperliquid -- npx -y @kitsune-de/hyperliquid-mcp
```

### Claude Desktop / Cursor / any MCP client

```json
{
  "mcpServers": {
    "hyperliquid": {
      "command": "npx",
      "args": ["-y", "@kitsune-de/hyperliquid-mcp"]
    }
  }
}
```

### From source

```bash
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

```bash
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

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [kitsune-de](https://github.com/kitsune-de)
- **Source:** [kitsune-de/hyperliquid-mcp](https://github.com/kitsune-de/hyperliquid-mcp)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-kitsune-de-hyperliquid-mcp
- Seller: https://agentstack.voostack.com/s/kitsune-de
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.