Hyperliquid MCP Server Integration

What does “Hyperliquid” MCP Server do?

The Hyperliquid MCP (Model Context Protocol) Server acts as an integration layer between AI assistants and the Hyperliquid trading platform (https://app.hyperliquid.xyz). By exposing Hyperliquid’s market data and trading resources via the MCP, it allows AI-powered workflows to interact programmatically with real-time and historical trading data. This enables AI agents to retrieve mid prices for all coins, access order book data, and obtain candlestick history, which can be used for analysis, trading automation, or market intelligence. The Hyperliquid MCP Server thus bridges the gap between AI assistants and the fast-evolving landscape of decentralized trading, streamlining the development of intelligent trading tools, bots, or research assistants.

List of Prompts

No prompt templates are mentioned in the available documentation or repository files.

List of Resources

No explicit MCP resources are mentioned or documented in the available repository files.

List of Tools

• get_all_mids
  • Retrieves mid prices for all coins on Hyperliquid. No inputs required.
• get_candle_snapshot
  • Fetches historical candlestick data for any token. Inputs: coin (token symbol), interval (e.g., ‘15m’, ‘1h’), startTime (ms since epoch), endTime (optional, ms since epoch).
• get_l2_book
  • Provides access to the Level 2 order book for any token. Input: symbol (token symbol).

Use Cases of this MCP Server

• Market Data Aggregation
  • Developers can build dashboards or bots that aggregate mid prices for all coins, providing real-time overviews for traders and analysts.
• Historical Price Analysis
  • By accessing candlestick snapshots, researchers and quant developers can backtest trading strategies or analyze market trends programmatically.
• Order Book Monitoring
  • Automated systems or AI agents can monitor Level 2 order books for specific tokens, enabling sophisticated trading strategies or alerting mechanisms.
• Intelligent Trading Assistants
  • Integrate with AI chatbots to answer user questions about market status, historical prices, or order book depth directly within productivity tools.
• Automated Reporting
  • Use the MCP server to periodically fetch and summarize Hyperliquid market data for newsletters, reporting tools, or compliance workflows.

How to set it up

Windsurf

1. Ensure Node.js and NPX are installed on your machine.
2. Open your Windsurf configuration file.
3. Add the Hyperliquid MCP Server using the following JSON snippet:

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

4. Save the configuration and restart Windsurf.
5. Verify that the Hyperliquid MCP Server is running and accessible.

Claude

1. Install Node.js and NPX if not already installed.
2. Locate your claude_desktop_config.json file.
3. Add the following entry under mcpServers:

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

4. Save the file and restart Claude Desktop.
5. Confirm connection to the Hyperliquid MCP Server.

Cursor

1. Make sure Node.js and NPX are installed.
2. Open Cursor’s configuration file for MCP servers.
3. Insert the following JSON configuration:

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

4. Save and restart Cursor.
5. Check that the Hyperliquid MCP Server is active.

Cline

1. Install Node.js and NPX.
2. Edit your Cline configuration file.
3. Add the Hyperliquid MCP Server configuration:

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

4. Save changes and restart Cline.
5. Ensure the MCP server is responding to requests.

Securing API Keys

• If the Hyperliquid MCP Server requires API keys or secrets, store them as environment variables rather than hardcoding.
• Example configuration:

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

• Set the HYPERLIQUID_API_KEY in your system/environment variable manager.

How to use this MCP inside flows

Using MCP in FlowHunt

To integrate MCP servers into your FlowHunt workflow, start by adding the MCP component to your flow and connecting it to your AI agent:

Click on the MCP component to open the configuration panel. In the system MCP configuration section, insert your MCP server details using this JSON format:

{
  "hyperliquid": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Once configured, the AI agent is now able to use this MCP as a tool with access to all its functions and capabilities. Remember to change “hyperliquid” to whatever the actual name of your MCP server is and replace the URL with your own MCP server URL.

Overview

Based on the above, the Hyperliquid MCP Server provides core trading data integration but lacks prompt templates, explicit resources, or advanced MCP features like roots or sampling. For developers needing market data tools, it is functional and straightforward, but somewhat limited in feature scope. I would rate this MCP server a 5 out of 10—solid for basic integration but not comprehensive in MCP capabilities.

MCP Score