Hyperliquid Mcp

io.github.kitsune-dePublished by GitHub account kitsune-dev0.1.0Updated Oct 24, 2026

Read-only Hyperliquid data: markets, funding rates, order books, candles, positions and fills

VerifiedSTDIODesktop onlyFinanceData & Analytics

Overview

AI-generated overview

A read-only MCP server that lets an assistant query Hyperliquid perpetual markets, funding rates, order books, candles, and any address's positions and fills.

What you can do
Look up perp markets with mark price, 24h change, volume, open interest, funding and max leverage, and fetch mid prices for specific coins or all perps. Read L2 order book snapshots with best bid/ask and spread, and pull OHLCV candles from 1m to 1w. Inspect any address's account value, margin usage, positions with liquidation prices, and spot balances. Review resting open orders and recent fills with direction, notional, closed PnL and fees. Summarize net funding paid or received per coin over a chosen time window.
When to use it
Useful when you want an assistant to analyze Hyperliquid perpetual markets or inspect on-chain trading activity for your own or another public address, without any trading capability. Good for funding-rate comparisons, order book and candle review, and position or liquidation-risk questions.
Requirements
Runs locally over stdio, typically launched with npx from the npm package, so Node.js and network access to the Hyperliquid Info API are needed. No API keys or wallets. An optional HL_INFO_URL environment variable points at the testnet endpoint instead of mainnet.
Before you install
Read-only by design and cannot trade or sign, but it queries public on-chain data for any address, so account details you ask about are visible to the upstream API. Market data is informational only and not financial advice; verify figures before acting on them.

Installation

In SourceWeft

  1. Open Hyperliquid Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

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-mcpcd 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

ToolArgumentsReturns
get_marketscoin?, sortBy? (volume · funding · change · openInterest), limit?Perp markets: mark price, 24h change & volume, open interest, funding (1h + annualized APR), max leverage
get_pricecoins?Mid prices for given coins, or all perp mids
get_orderbookcoin, depth?L2 snapshot: best bid/ask, spread %, levels per side
get_candlescoin, interval?, count?OHLCV candles (1m … 1w)
get_accountaddressAccount value, margin usage, withdrawable, every perp position (side, size, entry, liq price, uPnL, leverage), spot balances
get_open_ordersaddressResting orders: side, price, size, type, trigger info
get_recent_fillsaddress, limit?Recent fills: direction, price, size, notional, closed PnL, fees
get_funding_paidaddress, 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 varDefaultPurpose
HL_INFO_URLhttps://api.hyperliquid.xyz/infoSet to https://api.hyperliquid-testnet.xyz/info for testnet

Development

bash
npm installnpm run buildnpm 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: README.md at commit b2bf5c6

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts