MCP.Market

Hyperliquid MCP server

by kitsune-de·io.github.kitsune-de/hyperliquid-mcp·v0.1.0·1 stars

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

A85/100grade A
What users say
No reviews yet
Be the first
Safety scan
A85/100

full report

Adoption
New

1 stars29 downloads/wk

Reviews

Write one

Nobody 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 posts

Read from the package source without running it. The installed server may list more.

  • get_account

    Full account state for any Hyperliquid address: account value, margin usage, withdrawable, every open perp position

  • get_candles

    Historical OHLCV candles for a perp market. Intervals: ….

  • get_funding_paid

    Net funding paid or received by an address over the last N hours, broken down by coin. Positive = received, negative = paid.

  • get_markets

    List Hyperliquid perpetual markets with mark price, 24h change, 24h volume, open interest, funding rate (1h and annualized APR) and max leverage.

  • get_open_orders

    Resting open orders for an address: side, price, size, order type, trigger info.

  • get_orderbook

    L2 order book snapshot for a perp market: best bid/ask, spread, and aggregated levels per side.

  • get_price

    Current mid prices. Pass `coins` for specific perp markets (e.g. ["BTC", "ETH"]) or omit to get all perp mids at once.

  • get_recent_fills

    Most 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

no findings
  • 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
Overall 85/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

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
Add to Cursor

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

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 mainnet

Disclaimer

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 Exchanges
    Unofficial read-only Iranian crypto exchanges: prices in Toman, order books, trades, candles.
    A
  • Polymarket Toolkit
    Read-only Polymarket data tools for AI agents: profiles, PnL, market scans. No keys, no orders.
    B
  • Polymarket Paper Trader
    Polymarket paper trading for AI agents: $10k paper money, real order books, official fees.
    A
  • Longbridge
    US/HK markets — 163 tools: quotes, options, orders, fundamentals, screener, IPO, alerts, DCA & grid
    A
  • Omie
    MCP server for Omie — ERP, customers, products, orders, invoices, financials
    B