Hyperliquid MCP server

This server implements the Model Context Protocol (MCP) for interfacing with the Hyperliquid exchange, allowing you to retrieve market data like mid prices, historical candlesticks, and order book information through a standardized interface.

Available Tools

get_all_mids

Retrieves mid prices for all cryptocurrencies available on Hyperliquid.

• No required inputs
• Returns current mid prices for all tokens

get_candle_snapshot

Fetches historical candlestick data for any token on Hyperliquid.

• Required inputs:
  • coin (string): The token symbol (e.g., "BTC")
  • interval (string): Time interval for candles (e.g., "15m", "1h")
  • startTime (number): Start time in milliseconds since epoch
  • endTime (number, optional): End time in milliseconds since epoch

get_l2_book

Provides access to the L2 order book data for any token.

• Required inputs:
  • symbol (string): The token symbol to retrieve order book data for

Installation and Setup

The easiest way to use this server is through NPX, which requires no installation. Simply configure your MCP client to use it as shown in the examples below.

Configuration with Claude Desktop

To use this MCP server with Claude Desktop, add the following configuration to your claude_desktop_config.json file:

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

Usage Examples

Once configured, you can call the available tools through your MCP client application. Here are some examples of how you might use each tool:

Getting all mid prices

Use the get_all_mids tool to retrieve current prices of all tokens on Hyperliquid.

Fetching candlestick data

Use the get_candle_snapshot tool with the following parameters:
- coin: "ETH"
- interval: "1h"
- startTime: 1682352000000  (represents Apr 24, 2023)

Retrieving order book data

Use the get_l2_book tool with the following parameter:
- symbol: "BTC"

How to add this MCP server to Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > MCP and click "Add new global MCP server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "cursor-rules-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "cursor-rules-mcp"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explictly ask the agent to use the tool by mentioning the tool name and describing what the function does.