Hyperliquid MCP Server

What is Hyperliquid MCP Server about?

Hyperliquid MCP Server implements a set of MCP tools that expose Hyperliquid market data—mid prices for all symbols, candlestick history for a specific token, and the Level 2 order book—for consumption by AI agents or other applications.

How to use Hyperliquid MCP Server?

Add the server to your claude_desktop_config.json (or equivalent MCP configuration) using the NPX shortcut:

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

Run the configured command; the server will start listening for MCP calls. Each tool can then be invoked with the required parameters.

Key features of Hyperliquid MCP Server

• get_all_mids – Returns the latest mid prices for every coin listed on Hyperliquid without any input.
• get_candle_snapshot – Retrieves historical candlestick data for a token; customizable interval and time range.
• get_l2_book – Provides the full Level 2 order‑book for a specified symbol.
• Simple NPX‑based installation, no manual dependency management.
• MIT‑licensed, allowing free modification and redistribution.

Use cases of Hyperliquid MCP Server

• Building trading bots that need real‑time price references.
• Supplying market data to financial analytics dashboards.
• Enabling AI agents to answer questions about crypto market conditions.
• Collecting historical price series for back‑testing strategies.
• Integrating order‑book depth into risk‑management tools.

FAQ from the Hyperliquid MCP Server

Q: Do I need an API key to access Hyperliquid data? A: The server uses the public Hyperliquid SDK endpoints that do not require authentication for the provided tools.

Q: Can I customize the server port? A: The server follows the standard MCP configuration; custom ports can be set via environment variables if the underlying package supports them.

Q: Is the server compatible with other MCP clients besides Claude Desktop? A: Yes, any client that follows the MCP specification can interact with the exposed tools.

Q: How often are the mid‑price and order‑book data refreshed? A: Data is fetched live from Hyperliquid on each request, ensuring the latest market state.

Q: Where can I find the source code and license? A: The repository is https://github.com/mektigboy/server-hyperliquid and the project is licensed under the MIT License.

Hyperliquid MCP Server

An MCP server implementation that integrates the Hyperliquid SDK.

Tools

• get_all_mids

  • Retrieve mid prices for all coins on Hyperliquid
  • No required inputs

• get_candle_snapshot

  • Get historical candlestick data for any token
  • Inputs:
    • coin (string): Token symbol
    • interval (string): Time interval (e.g., '15m', '1h')
    • startTime (number): Start time in milliseconds since epoch
    • endTime (number, optional): End time in milliseconds since epoch

• get_l2_book

  • Access the L2 order book for any token
  • Inputs:
    • symbol (string): Token symbol

Usage with Claude Desktop

Add this to your claude_desktop_config.json:

NPX

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

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.