Hyperliquid MCP Updated
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Hyperliquid MCP Updated show me the L2 book for BTC"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Hyperliquid MCP Updated
Read-only Model Context Protocol server for Hyperliquid using the official hyperliquid-python-sdk (see pyproject.toml). Use this when third-party MCP wrappers drift from the SDK.
Features
No private key — only public
POST /infoendpoints.One MCP tool per
InfoHTTP method (all read-only SDK methods that call/info), plushl_info_requestfor any extra documentedtypenot yet wrapped.Not included: WebSocket
subscribe/unsubscribe,Exchange(signing / trading), and internal helpers likeset_perp_meta.
Related MCP server: hyperliquid-mcp
Install
cd Hyperliquid-MCP-Updated
uv venv && source .venv/bin/activate # or: python -m venv .venv
uv pip install -e .Run (stdio, for MCP clients):
hyperliquid-mcp-updatedEnvironment
Variable | Meaning |
|
|
| Override base URL entirely |
| Default |
Cursor mcp.json
Local checkout (replace path):
{
"mcpServers": {
"hyperliquid-updated": {
"command": "/Users/you/path/to/Hyperliquid-MCP-Updated/.venv/bin/hyperliquid-mcp-updated",
"args": [],
"env": {}
}
}
}Or with uv (no venv path hardcoded):
{
"mcpServers": {
"hyperliquid-updated": {
"command": "/Users/you/.local/bin/uv",
"args": [
"--directory",
"/Users/you/path/to/Hyperliquid-MCP-Updated",
"run",
"hyperliquid-mcp-updated"
],
"env": {}
}
}
}After editing, reload MCP in Cursor settings.
Tools ↔ hyperliquid.info.Info (SDK)
MCP tool | SDK method |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| (no SDK method) → |
| (no SDK method) → |
| raw |
Publish to GitHub
cd Hyperliquid-MCP-Updated
git init
git remote add origin https://github.com/lucaluca-04/Hyperliquid-MCP-Updated.git
git add .
git commit -m "Initial hyperliquid-mcp-updated server"
git branch -M main
git push -u origin mainLicense
MIT
Available Tools
41 toolshl_active_asset_dataB
Per-user per-coin leverage, max trade sizes, available to trade (activeAssetData). Official HTTP Info; SDK exposes mainly via WS.
Inputs: coin (required), user (required). Returns: result
hl_all_midsC
Mid prices for all assets (allMids).
Inputs: dex. Returns: result
hl_candlesC
OHLCV candles: interval like 1m, 1h, 1d.
Inputs: coin (required), interval (required), end_time_ms (required), start_time_ms (required). Returns: result
hl_clearinghouse_stateC
Perpetual clearinghouse state: positions, margin summary, withdrawable (clearinghouseState).
Inputs: user (required), dex. Returns: result
hl_delegator_historyC
Delegate / undelegate history (delegatorHistory).
Inputs: user (required). Returns: result
hl_extra_agentsD
Extra API agents linked to user (extraAgents).
Inputs: user (required). Returns: result
hl_frontend_open_ordersC
Open orders including trigger/TPSL-style visibility (frontendOpenOrders).
Inputs: user (required), dex. Returns: result
hl_funding_historyC
Historical funding rates for a perp coin (not user-specific).
Inputs: coin (required), start_time_ms (required), end_time_ms. Returns: result
hl_historical_ordersC
Historical orders for user (historicalOrders).
Inputs: user (required). Returns: result
hl_info_requestA
Advanced: raw POST /info. request_type maps to JSON "type" field; payload is JSON object merged in.
Example: request_type="vaultDetails", payload='{"vaultAddress": "0x..."}' Only use for types documented in Hyperliquid API; invalid types will error.
Inputs: request_type (required), payload. Returns: result
hl_l2_bookB
L2 order book snapshot for a coin symbol (e.g. BTC, ETH).
Inputs: coin (required). Returns: result
hl_metaC
Perp metadata: universe, sz decimals (meta).
Inputs: dex. Returns: result
hl_meta_and_asset_ctxsB
Perp meta plus per-asset mark/oracle/funding/OI context (metaAndAssetCtxs).
Inputs: no named parameters. Returns: result
hl_open_ordersC
Open resting orders for a user.
Inputs: user (required), dex. Returns: result
hl_order_status_by_cloidC
Order status by client order id: 0x + 32 hex chars (16 bytes) (orderStatus).
Inputs: user (required), cloid_hex (required). Returns: result
hl_order_status_by_oidB
Order status by numeric order id (orderStatus).
Inputs: oid (required), user (required). Returns: result
hl_perp_deploy_auction_statusD
Perp deploy auction status (perpDeployAuctionStatus).
Inputs: no named parameters. Returns: result
hl_perp_dexsB
List perp dex deployments (perpDexs).
Inputs: no named parameters. Returns: result
hl_portfolioC
Portfolio performance snapshot (account value / PnL history payloads).
Inputs: user (required). Returns: result
hl_predicted_fundingsB
Predicted funding across venues (HlPerp / BinPerp / BybitPerp) — same idea as Funding Comparison UI (predictedFundings).
Inputs: no named parameters. Returns: result
hl_referral_stateD
Referral program state (referral).
Inputs: user (required). Returns: result
hl_spot_clearinghouse_stateC
Spot clearinghouse balances (spotClearinghouseState).
Inputs: user (required). Returns: result
hl_spot_deploy_auction_statusB
Spot deploy auction status for user (spotDeployState).
Inputs: user (required). Returns: result
hl_spot_metaB
Spot pair metadata (spotMeta).
Inputs: no named parameters. Returns: result
hl_spot_meta_and_asset_ctxsD
Spot meta plus asset contexts (spotMetaAndAssetCtxs).
Inputs: no named parameters. Returns: result
hl_sub_accountsD
Sub-accounts for master (subAccounts).
Inputs: user (required). Returns: result
hl_user_abstractionD
Unified account / portfolio margin abstraction (userAbstraction).
Inputs: user (required). Returns: result
hl_user_dex_abstractionD
HIP-3 dex abstraction state (userDexAbstraction).
Inputs: user (required). Returns: result
hl_user_feesC
User fee tier and daily volume stats (userFees).
Inputs: user (required). Returns: result
hl_user_fillsA
Recent user fills (bounded by API; use hl_user_fills_by_time for a window).
Inputs: user (required). Returns: result
hl_user_fills_by_timeC
User fills between start_time_ms and optional end_time_ms (userFillsByTime).
Inputs: user (required), start_time_ms (required), end_time_ms, aggregate_by_time. Returns: result
hl_user_funding_historyC
User funding payments (userFunding).
Inputs: user (required), start_time_ms (required), end_time_ms. Returns: result
hl_user_non_funding_ledger_updatesC
Non-funding ledger: deposits, transfers, liquidations, etc.
Inputs: user (required), start_time_ms (required), end_time_ms. Returns: result
hl_user_rate_limitC
User API rate limit info (userRateLimit).
Inputs: user (required). Returns: result
hl_user_roleD
Account role metadata (userRole).
Inputs: user (required). Returns: result
hl_user_staking_delegationsD
Active staking delegations (delegations).
Inputs: user (required). Returns: result
hl_user_staking_rewardsC
Staking reward history (delegatorRewards).
Inputs: user (required). Returns: result
hl_user_staking_summaryD
Staking summary for user (delegatorSummary).
Inputs: user (required). Returns: result
hl_user_to_multi_sig_signersC
Multi-sig signers for address (userToMultiSigSigners).
Inputs: multi_sig_user (required). Returns: result
hl_user_twap_slice_fillsC
Recent TWAP slice fills (userTwapSliceFills).
Inputs: user (required). Returns: result
hl_user_vault_equitiesC
User's equity across Hyperliquid vaults (userVaultEquities).
Inputs: user (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 41 tools
Most tools target distinct data types, but several near-duplicates exist (e.g., hl_open_orders vs hl_frontend_open_orders; hl_user_fills vs hl_user_fills_by_time; hl_meta vs hl_meta_and_asset_ctxs). Descriptions help differentiate them, but an agent could still easily misselect between pairs that differ only in subtle scope or parameters.
All tools consistently use the 'hl_' prefix with snake_case and descriptive noun phrases (e.g., hl_user_funding_history, hl_candles, hl_spot_meta). The naming pattern is highly predictable and uniform across all 41 tools.
41 tools is a large surface, but it reflects the broad Hyperliquid API info endpoints. However, many tools are near variants of one another (meta, meta_and_asset_ctxs, user_fills variants), inflating the count and making navigation more difficult than necessary.
The toolset covers an extensive range of read-only query endpoints, but entirely lacks any write/trading tools (order placement, cancellation, transfers, staking actions). For a trading-focused server, this is a significant gap that would prevent agents from executing core workflows.
Maintenance
Related MCP Connectors
Hyperliquid MCP — read-only market data from Hyperliquid's public info API.
Read-only Hyperliquid analytics: orderflow, liquidation levels, whale positioning, funding.
Hyperliquid market data, wallet analytics and liquidation alerts for AI agents.
Read-only crypto market data: Hyperliquid liquidation heatmaps, liquidations, whales, funding, flow.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server providing comprehensive tools to access real-time market data, trading information, user positions, and analytics for the Hyperliquid perpetual futures exchange.5MIT
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol (MCP) server for the Hyperliquid decentralized exchange, enabling AI assistants to perform trading operations, manage accounts, and retrieve market data.45 PyPI3MIT
- AlicenseNot gradedqualityDmaintenanceA read-only MCP server for Hyperliquid that provides public market data (prices, order books, funding) and any wallet's positions, orders, and fills via MCP tools, without requiring a private key.MIT
- AlicenseAqualityDmaintenanceA read-only MCP server for querying Hyperliquid perp markets, funding rates, order books, candles, and account positions/fills/funding for any address, without needing API keys or wallets.82MIT