How to add Hyperliquid Info MCP Server to Claude Desktop

Real-time Hyperliquid perp DEX data and insights for bots, dashboards, and analytics. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Last updated June 14, 2026 · 29★ · stdio · no auth

Claude Desktop config for Hyperliquid Info MCP Server

git clone https://github.com/kukapay/hyperliquid-info-mcp.git && cd hyperliquid-info-mcp && uv sync

{
  "mcpServers": {
    "hyperliquid-info-mcp-server": {
      "command": "mcp",
      "args": [
        "run",
        "main.py"
      ]
    }
  }
}

Setup steps

1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
2Paste the Hyperliquid Info MCP Server config below under the top-level "mcpServers" key.
3Fill in any placeholder secrets (API keys, paths) in the snippet.
4Save the file, then fully quit and reopen Claude Desktop.
5Open a chat and confirm Hyperliquid Info MCP Server's tools appear under the 🔌 tools menu.

Before you start

Python 3.10 (required by the Hyperliquid Python SDK)
uv or pip for package management
A valid Hyperliquid account address for user-specific queries

What Hyperliquid Info MCP Server can do in Claude Desktop

get_user_state

Fetch user positions, margin, and withdrawable balance for perpetuals or spot markets.

get_user_open_orders

Retrieve all open orders for a user account.

get_user_trade_history

Get trade fill history with details like symbol, size, and price.

get_user_funding_history

Query funding payment history with customizable time ranges (ISO 8601 supported).

get_user_fees

Fetch user-specific fee structures (maker/taker rates).

get_user_staking_summary

Access a user's staking summary details.

get_user_staking_rewards

Access a user's staking rewards.

get_user_order_by_oid

Retrieve specific order details by order ID (oid).

Security

Read-only: the server queries public Hyperliquid Info data and account-level read endpoints. No private key or API key is required; user-specific queries take a public wallet address as a parameter, so no signing credentials are stored or transmitted. Requires Python 3.10 (per the Hyperliquid Python SDK).

Hyperliquid Info MCP Server + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the Hyperliquid Info MCP Server config there under the "mcpServers" key and restart the client.

Is Hyperliquid Info MCP Server safe to use with Claude Desktop?

Does it need a private key or API key?

No. The server queries public Hyperliquid Info endpoints and account-level read data using a public wallet address parameter. No API key or signing key is required.

How do I install it into Claude Desktop?

Clone the repo, run `uv sync`, then `mcp install main.py --name "Hyperliquid Info"`. You can also run `mcp dev main.py` to inspect it with the MCP Inspector.

What Python version is required?

Python 3.10, which is required by the Hyperliquid Python SDK.

View repo Full Hyperliquid Info MCP Server page