Hyperliquid MCP Server v4

A streamlined version of the Hyperliquid MCP Server that can be set up with a single command in HL Coder, with proper integration into the main project.

Features

• One-Command Setup: Fully automates the setup process for both the MCP server and dashboard
• Proper Integration: Correctly sets up all files in the main project directory
• 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
• Dashboard: Visual interface for account management and monitoring

Quick Start

To set up the Hyperliquid MCP server and dashboard in your HL Coder environment, simply paste this command:

git clone https://github.com/tradingbalthazar/hyperliquid-mcp-server-v4.git && cd hyperliquid-mcp-server-v4 && ./setup.sh && cd ..

This single command will:

1. Clone this repository
2. Install all dependencies
3. Build the MCP server
4. Configure the MCP server for use with HL Coder
5. Create the API endpoint in your Next.js project
6. Update your index page with the Hyperliquid dashboard
7. Install the hyperliquid package in your main project

After setup, you can access the dashboard at http://localhost:3000.

Using with HL Coder

Once set up, you can use the MCP server 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
• The dashboard uses secure input fields for sensitive information

License

MIT