MCP.Market

Hyperliquid Info MCP server

by Glebenjoy·io.github.Glebenjoy/hyperliquid-info-mcp·v1.0.0

Hyperliquid perp & spot data: prices, funding, open interest, order book, positions. No API key.

B82/100grade B
What users say
No reviews yet
Be the first
Safety scan
B82/100

full report

Adoption
New

0 stars41 downloads/wk

Reviews

Write one

Nobody has reviewed Hyperliquid Info yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Hyperliquid Info tools (7, 1 write)

write = sends, deletes, buys or posts

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

  • get_all_mids

    Current mid prices for every Hyperliquid market. Optionally filter to specific coins (comma-separated, e.g. 'BTC,ETH,SOL'). Fast way to check live prices.

  • get_funding_history

    Recent funding-rate history for a Hyperliquid perp (e.g. 'BTC'), with the average over the window. Useful for carry / basis and funding-trend analysis.

  • get_market

    Detailed snapshot of a single Hyperliquid perpetual market by coin symbol (e.g. 'BTC'): mark/oracle/mid price, 24h change & volume, funding (hourly + annualized), open interest, premium, and max leverage.

  • get_order_bookwrite action

    Live L2 order book for a Hyperliquid market (e.g. 'BTC'): top bids and asks with sizes, plus the spread. Works for perps (BTC) and spot pairs (e.g. 'HYPE/USDC').

  • get_perp_markets

    Overview of all Hyperliquid perpetual markets: mark price, 24h change, 24h volume, open interest, funding rate, and max leverage. Sort by 'volume', 'oi', 'funding', 'change', 'gainers', or 'losers'.

  • get_spot_markets

    Overview of Hyperliquid spot markets (HYPE, PURR, and other HIP-1 tokens): price, 24h change, 24h volume, and market cap. Sort by 'volume', 'change', 'gainers', or 'losers'.

  • get_user_state

    Perp account state for any Hyperliquid wallet address (0x...): account value, total notional, margin used, withdrawable balance, and every open position with side, size, entry, unrealized PnL, liquidation price, and leverage.

Public scan report

scanner v0.1.9 · 2026-09-27 · 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 113 days ago8/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 82/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Hyperliquid Info compares

Against every graded E-commerce MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
82/100
higher than 75% of 2,174 E-commerce servers
Tools
7
the typical E-commerce server has 6
Tools that change things
14%
typical: 0%. Fewer write tools means less an agent can break
Downloads a week
41
more than 39% of 411 E-commerce servers with a package

What its tools let an agent do: 6 read · 1 change

Install Hyperliquid Info in Claude Code, Cursor or VS Code

Runs npx -y hyperliquid-info-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add hyperliquid-info-mcp -- npx -y hyperliquid-info-mcp
Add to Cursor

What the publisher says

From the Hyperliquid Info repository's README, as published. We do not edit it. Read it on GitHub

Hyperliquid Info MCP

An MCP server that gives Claude, Cursor, and any MCP-compatible agent live market and account data from Hyperliquid — 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

Install

No install needed. It runs straight from npm via npx.

Claude Desktop

Add to claudedesktopconfig.json:

{
  "mcpServers": {
    "hyperliquid": {
      "command": "npx",
      "args": ["-y", "hyperliquid-info-mcp"]
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "hyperliquid": {
      "command": "npx",
      "args": ["-y", "hyperliquid-info-mcp"]
    }
  }
}

Restart the client and the hyperliquid tools appear.

Notes

endpoint. This server places no orders and never needs a private key.

  • All data is read-only market/account info from the public https://api.hyperliquid.xyz/info

traders actually compare.

  • Funding is shown both per-hour (how Hyperliquid charges it) and annualized, which is what
  • getuserstate works for any public wallet address — it reads the same data the explorer shows.

Develop

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.

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.

Nothing above is checked by us. What we check is on the safety report.

Hyperliquid Info: common questions

Is Hyperliquid Info MCP server safe?
Mostly: it is graded B (82/100). Read the Hyperliquid Info safety report
How do I install Hyperliquid Info?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Hyperliquid Info need an API key?
Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is Hyperliquid Info maintained?
The last commit was 151 days ago (2026-06-06). The latest release is v1.0.0.
What can I use instead of Hyperliquid Info?
Servers from other publishers that do the same job: Iran Crypto Exchanges MCP server, Polymarket Paper Trader MCP server and Tiny MCP server.
How does Hyperliquid Info compare with other E-commerce MCP servers?
safety score 82/100 (higher than 75% of 2,174 E-commerce servers); tools 7 (the typical E-commerce server has 6); tools that change things 14% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Hyperliquid Info

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 Paper Trader
    Polymarket paper trading for AI agents: $10k paper money, real order books, official fees.
    A
  • Tiny
    MCP server for Tiny ERP — products, stock, warehouses, price lists, orders, invoices, AP/AR
    B
  • Polymarket Toolkit
    Read-only Polymarket data tools for AI agents: profiles, PnL, market scans. No keys, no orders.
    B
  • Sv Number
    Phone numbers for AI agents: order a private number, read the SMS verification code, hand it back.
    B

More from Glebenjoy →