Hyperliquid MCP Server

A Model Context Protocol (MCP) server for interacting with the Hyperliquid exchange API through HL Coder or Claude.

Features

- Authentication: Connect to Hyperliquid using private keys or wallet addresses
- Trading: Place and cancel orders on the Hyperliquid exchange
- Market Data: Retrieve real-time market data for trading pairs
- Strategy Management: Create and manage custom trading strategies

Installation for HL Coder

1. Clone this repository into your HL Coder environment:

git clone https://github.com/TradingBalthazar/hyperliquid-mcp-server-v1.git

cd hyperliquid-mcp-server-v1

2. Install dependencies:

npm install

3. Build the server:

npm run build

4. Configure the MCP server in your HL Coder settings file:

{

  "mcpServers": {

    "hyperliquid": {

      "command": "node",

      "args": ["/path/to/hyperliquid-mcp-server-v1/build/index.js"],

      "disabled": false,

      "alwaysAllow": []

    }

  }

}

Dashboard Setup (Optional)

This repository includes a companion dashboard for managing your Hyperliquid credentials and viewing account balances. To set it up:

1. Create a new Next.js project or use an existing one:

npx create-next-app hyperliquid-dashboard

cd hyperliquid-dashboard

2. Install required dependencies:

npm install hyperliquid ethers

3. Create the API endpoint and dashboard page:
- Create a file at src/pages/api/hyperliquid.ts with the API endpoint code
- Update your src/pages/index.tsx with the dashboard interface

You can find the code for these files in the dashboard directory of this repository.

4. Start the dashboard:

npm run dev

5. Access the dashboard at http://localhost:3000

Usage with HL Coder

Once the server is configured, you can use it with HL Coder through the following tools:

Authentication

<use_mcp_tool>
<server_name>hyperliquid</server_name>
<tool_name>authenticate</tool_name>
<arguments>
{
  "privateKey": "your-private-key",
  "testnet": true
}
</arguments>
</use_mcp_tool>

Get Market Data

<use_mcp_tool>
<server_name>hyperliquid</server_name>
<tool_name>get_market_data</tool_name>
<arguments>
{
  "symbol": "BTC-PERP"
}
</arguments>
</use_mcp_tool>

Place an Order

<use_mcp_tool>
<server_name>hyperliquid</server_name>
<tool_name>place_order</tool_name>
<arguments>
{
  "symbol": "ETH-PERP",
  "side": "buy",
  "size": 0.1,
  "price": 3000,
  "orderType": "limit",
  "reduceOnly": false
}
</arguments>
</use_mcp_tool>

Create a Strategy

<use_mcp_tool>
<server_name>hyperliquid</server_name>
<tool_name>create_strategy</tool_name>
<arguments>
{
  "name": "Simple Moving Average Crossover",
  "description": "Buy when short MA crosses above long MA, sell when it crosses below",
  "config": {
    "symbol": "BTC-PERP",
    "shortPeriod": 10,
    "longPeriod": 50,
    "positionSize": 0.01
  }
}
</arguments>
</use_mcp_tool>

Security Considerations

- The MCP server stores credentials in memory only
- Always use testnet for testing before using real funds on mainnet
- Do not share your private keys or expose them in public repositories

License

MIT