home / mcp / hyperliquid mcp server

Hyperliquid MCP Server

MCP Hyperliquid (https://app.hyperliquid.xyz) server

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "mektigboy-server-hyperliquid": {
      "command": "npx",
      "args": [
        "-y",
        "@mektigboy/server-hyperliquid"
      ]
    }
  }
}

Hyperliquid MCP Server exposes Hyperliquid price data and market depth to MCP clients by implementing a small set of data endpoints. It integrates the Hyperliquid SDK and offers convenient tooling to query mid prices, candlestick data, and L2 order books from Hyperliquid for use in MCP workflows.

How to use

You connect to the Hyperliquid MCP Server from an MCP client to access live and historical market data. The server provides tools to retrieve all mid prices, candle snapshots for any token, and the L2 order book for a given symbol. Use the client to request the specific data you need, such as current mid prices across all coins, historical price candles for a token over a chosen interval, or the current depth of the market for a symbol. The server is designed to be straightforward to query from your MCP client with standard request patterns.

How to install

Prerequisites: you need Node.js installed on your machine. Preferably use an LTS version (for example Node 18 or later) and npm that comes with it.

Step 1: Install Node.js and npm if they are not already installed. Visit the official Node.js website and follow the installation instructions for your operating system.

Step 2: Run the MCP server using NPX without installing the package globally. This fetches the server package and runs it directly.

# Start the Hyperliquid MCP Server with NPX
npx -y @mektigboy/server-hyperliquid

Additional content

Configuration notes: You can run the server as a stdio MCP server using NPX, which does not require a prior install of the package. The server exposes a small set of tools that you will call from your MCP client as described in the Tools section.

Configuration and endpoints

Below is a ready-to-use MCP configuration example showing how to run the Hyperliquid MCP Server as a stdio MCP server via NPX. Use this snippet as a starting point in your MCP client configuration.

{
  "mcpServers": {
    "hyperliquid": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@mektigboy/server-hyperliquid"]
    }
  }
}

Available tools

get_all_mids

Retrieve mid prices for all coins on Hyperliquid. Requires no inputs.

get_candle_snapshot

Get historical candlestick data for any token. Inputs include coin symbol, interval (e.g., '15m', '1h'), startTime in ms, and optional endTime in ms.

get_l2_book

Access the L2 order book for any token by symbol.