hyperliquid-mcp

> Control your Hyperliquid perps from Claude (or any MCP client) using natural language.

"What's my BTC PnL?" → Claude fetches your positions and answers in seconds. "Buy 0.1 ETH at market" → Claude places the order via Hyperliquid API.

Built with the Model Context Protocol — the open standard for connecting AI to external tools.

---

| Tool | Description | |------|-------------| | hl_get_all_mids | Prices for all assets | | hl_get_orderbook | L2 bids/asks for any asset | | hl_get_meta | Market info (leverage, tick size) | | hl_get_candles | OHLCV history (1m → 1d) | | hl_get_user_state | Positions, equity, margin, PnL | | hl_get_open_orders | Active orders | | hl_get_fills | Trade history | | hl_get_funding_history | Funding rate history | | hl_place_order | Place limit or market orders | | hl_cancel_order | Cancel specific order | | hl_cancel_all_orders | Cancel all orders (optional: by coin) | | hl_close_position | Close entire position | | hl_set_leverage | Set leverage (cross or isolated) |

---

pip install hyperliquid-mcp

Or run directly without installing:

uvx hyperliquid-mcp

Open ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows) and add:

Read-only mode (positions, prices, history — no private key needed):

{
  "mcpServers": {
    "hyperliquid": {
      "command": "uvx",
      "args": ["hyperliquid-mcp"],
      "env": {
        "HL_WALLET_ADDRESS": "0xYourWalletAddressHere"
      }
    }
  }
}

Trading mode (place orders, cancel, close positions):

{
  "mcpServers": {
    "hyperliquid": {
      "command": "uvx",
      "args": ["hyperliquid-mcp"],
      "env": {
        "HL_PRIVATE_KEY": "0xYourPrivateKeyHere"
      }
    }
  }
}

> ⚠️ **Neve