Skip to main content
Glama
Hyperliquid MCP Updated

Hyperliquid MCP Updated

by lucaluca-04

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 /info endpoints.

  • One MCP tool per Info HTTP method (all read-only SDK methods that call /info), plus hl_info_request for any extra documented type not yet wrapped.

  • Not included: WebSocket subscribe / unsubscribe, Exchange (signing / trading), and internal helpers like set_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-updated

Environment

Variable

Meaning

HL_TESTNET

true / 1 → https://api.hyperliquid-testnet.xyz

HL_API_URL

Override base URL entirely

HL_LOG_LEVEL

Default WARNING

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

hl_clearinghouse_state

user_state

hl_spot_clearinghouse_state

spot_user_state

hl_open_orders

open_orders

hl_frontend_open_orders

frontend_open_orders

hl_user_fills

user_fills

hl_user_fills_by_time

user_fills_by_time

hl_user_funding_history

user_funding_history

hl_portfolio

portfolio

hl_user_vault_equities

user_vault_equities

hl_user_role

user_role

hl_user_non_funding_ledger_updates

user_non_funding_ledger_updates

hl_historical_orders

historical_orders

hl_user_twap_slice_fills

user_twap_slice_fills

hl_user_fees

user_fees

hl_user_staking_summary

user_staking_summary

hl_user_staking_delegations

user_staking_delegations

hl_user_staking_rewards

user_staking_rewards

hl_delegator_history

delegator_history

hl_order_status_by_oid

query_order_by_oid

hl_order_status_by_cloid

query_order_by_cloid

hl_referral_state

query_referral_state

hl_sub_accounts

query_sub_accounts

hl_user_to_multi_sig_signers

query_user_to_multi_sig_signers

hl_perp_deploy_auction_status

query_perp_deploy_auction_status

hl_user_dex_abstraction

query_user_dex_abstraction_state

hl_user_abstraction

query_user_abstraction_state

hl_user_rate_limit

user_rate_limit

hl_spot_deploy_auction_status

query_spot_deploy_auction_status

hl_extra_agents

extra_agents

hl_meta

meta

hl_meta_and_asset_ctxs

meta_and_asset_ctxs

hl_perp_dexs

perp_dexs

hl_spot_meta

spot_meta

hl_spot_meta_and_asset_ctxs

spot_meta_and_asset_ctxs

hl_all_mids

all_mids

hl_l2_book

l2_snapshot

hl_candles

candles_snapshot

hl_funding_history

funding_history

hl_predicted_fundings

(no SDK method) → post(..., {"type":"predictedFundings"})

hl_active_asset_data

(no SDK method) → post(..., {"type":"activeAssetData", ...})

hl_info_request

raw post("/info", {**payload, "type": request_type})

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 main

License

MIT

Available Tools

41 tools
hl_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

    C2.5/5.0

    Scored across 41 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count3/5

    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.

    Completeness2/5

    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

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A 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.
      5
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol (MCP) server for the Hyperliquid decentralized exchange, enabling AI assistants to perform trading operations, manage accounts, and retrieve market data.
      45 PyPI
      3
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A 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
    • A
      license
      A
      quality
      D
      maintenance
      A 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.
      8
      2
      MIT