Hyperliquid MCP Updated
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| HL_API_URL | No | Override the base API URL entirely | |
| HL_TESTNET | No | Set to 'true' or '1' to use Hyperliquid testnet URL https://api.hyperliquid-testnet.xyz | |
| HL_LOG_LEVEL | No | Set logging level, default is WARNING |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| hl_clearinghouse_stateC | Perpetual clearinghouse state: positions, margin summary, withdrawable (clearinghouseState). |
| hl_spot_clearinghouse_stateC | Spot clearinghouse balances (spotClearinghouseState). |
| hl_open_ordersC | Open resting orders for a user. |
| hl_frontend_open_ordersC | Open orders including trigger/TPSL-style visibility (frontendOpenOrders). |
| hl_user_fillsA | Recent user fills (bounded by API; use hl_user_fills_by_time for a window). |
| hl_user_fills_by_timeC | User fills between start_time_ms and optional end_time_ms (userFillsByTime). |
| hl_user_funding_historyC | User funding payments (userFunding). |
| hl_portfolioC | Portfolio performance snapshot (account value / PnL history payloads). |
| hl_user_vault_equitiesC | User's equity across Hyperliquid vaults (userVaultEquities). |
| hl_user_roleD | Account role metadata (userRole). |
| hl_user_non_funding_ledger_updatesC | Non-funding ledger: deposits, transfers, liquidations, etc. |
| hl_historical_ordersC | Historical orders for user (historicalOrders). |
| hl_metaC | Perp metadata: universe, sz decimals (meta). |
| hl_meta_and_asset_ctxsB | Perp meta plus per-asset mark/oracle/funding/OI context (metaAndAssetCtxs). |
| hl_perp_dexsB | List perp dex deployments (perpDexs). |
| hl_spot_metaB | Spot pair metadata (spotMeta). |
| hl_spot_meta_and_asset_ctxsD | Spot meta plus asset contexts (spotMetaAndAssetCtxs). |
| hl_all_midsC | Mid prices for all assets (allMids). |
| hl_l2_bookB | L2 order book snapshot for a coin symbol (e.g. BTC, ETH). |
| hl_candlesC | OHLCV candles: interval like 1m, 1h, 1d. |
| hl_funding_historyC | Historical funding rates for a perp coin (not user-specific). |
| hl_predicted_fundingsB | Predicted funding across venues (HlPerp / BinPerp / BybitPerp) — same idea as Funding Comparison UI (predictedFundings). |
| hl_active_asset_dataB | Per-user per-coin leverage, max trade sizes, available to trade (activeAssetData). Official HTTP Info; SDK exposes mainly via WS. |
| hl_user_feesC | User fee tier and daily volume stats (userFees). |
| hl_user_staking_summaryD | Staking summary for user (delegatorSummary). |
| hl_user_staking_delegationsD | Active staking delegations (delegations). |
| hl_user_staking_rewardsC | Staking reward history (delegatorRewards). |
| hl_delegator_historyC | Delegate / undelegate history (delegatorHistory). |
| hl_order_status_by_oidB | Order status by numeric order id (orderStatus). |
| hl_order_status_by_cloidC | Order status by client order id: 0x + 32 hex chars (16 bytes) (orderStatus). |
| hl_referral_stateD | Referral program state (referral). |
| hl_sub_accountsD | Sub-accounts for master (subAccounts). |
| hl_user_to_multi_sig_signersC | Multi-sig signers for address (userToMultiSigSigners). |
| hl_perp_deploy_auction_statusD | Perp deploy auction status (perpDeployAuctionStatus). |
| hl_user_dex_abstractionD | HIP-3 dex abstraction state (userDexAbstraction). |
| hl_user_abstractionD | Unified account / portfolio margin abstraction (userAbstraction). |
| hl_user_twap_slice_fillsC | Recent TWAP slice fills (userTwapSliceFills). |
| hl_user_rate_limitC | User API rate limit info (userRateLimit). |
| hl_spot_deploy_auction_statusB | Spot deploy auction status for user (spotDeployState). |
| hl_extra_agentsD | Extra API agents linked to user (extraAgents). |
| 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. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
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.