Skip to main content
Glama
lucaluca-04

Hyperliquid MCP Updated

by lucaluca-04
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

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: Blockscout MCP Server

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

This server cannot be installed

A
license - permissive license
-
quality - not tested
D
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/lucaluca-04/Hyperliquid-MCP-Updated'

If you have feedback or need assistance with the MCP directory API, please join our Discord server