Hyperliquid MCP Server

What is Hyperliquid MCP Server?

This MCP server wraps the Hyperliquid SDK, exposing cryptocurrency trading capabilities to AI assistants. It enables AI assistants to interact with the Hyperliquid exchange for retrieving market data, executing trades, managing positions, and more.

How to use Hyperliquid MCP Server?

Clone the repository, install dependencies with npm install, and configure via environment variables or a .hyperliquid-config.json file. Required environment variables are HYPERLIQUID_PRIVATE_KEY and HYPERLIQUID_WALLET_ADDRESS. Start the server with npm start. A demo client is also available with npm run demo.

Key features of Hyperliquid MCP Server

• Complete Hyperliquid SDK APIs for spot and futures trading
• Market data retrieval (prices, order books, candles)
• Order placement and management (market, limit, trigger, TWAP)
• Position management (leverage, margin, closing)
• Account information and balances
• Vault, sub-account, and referral system integration

Use cases of Hyperliquid MCP Server

• Obtain real-time market prices and order books for analysis
• Place and manage market, limit, trigger, and TWAP orders
• Monitor and adjust positions, leverage, and margin
• Retrieve account balances, open orders, and fill history
• Perform transfers, withdrawals, and vault operations

FAQ from Hyperliquid MCP Server

What prerequisites are needed?

Node.js v14 or higher, a Hyperliquid account, an Ethereum private key, and a wallet address for authentication.

How do I switch between testnet and mainnet?

Set the environment variable HYPERLIQUID_TESTNET to 'true' for testnet or 'false' for mainnet (default is false).

What authentication is required?

An Ethereum private key and wallet address are required for trading. A vault address is optional for vault operations.

Is the server secure?

The private key provides full access to funds. The README advises never sharing it, using testnet first, and restricting access to trusted AI assistants and applications.