How to add Hyperliquid Info MCP Server to Cursor

Real-time Hyperliquid perp DEX data and insights for bots, dashboards, and analytics. Paste the config into ~/.cursor/mcp.json and restart Cursor.

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

Cursor 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 Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
2Paste the Hyperliquid Info MCP Server config below into the "mcpServers" object.
3Fill in placeholder secrets, then save.
4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
5Ask Cursor to use one of Hyperliquid Info MCP Server's tools to confirm it's connected.

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 Cursor

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 + Cursor FAQ

Where is the Cursor config file?

Cursor reads MCP servers from ~/.cursor/mcp.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 Cursor?

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