MCP Directory

How to add Hyperliquid Info MCP Server to Windsurf

Real-time Hyperliquid perp DEX data and insights for bots, dashboards, and analytics. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

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

Windsurf 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

  1. 1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
  2. 2Paste the Hyperliquid Info MCP Server config below.
  3. 3Fill in placeholder secrets, then save.
  4. 4Click Refresh in the MCP panel.
  5. 5Hyperliquid Info MCP Server's tools become available to Cascade.

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 Windsurf

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

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_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 Windsurf?

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).

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