Hyperliquid Exchange
Enables interaction with the Hyperliquid exchange to trade perpetuals, check positions, and manage risk through natural language. It provides tools for fetching real-time market data, tracking portfolio value, and executing orders with a focus on saf
What is Hyperliquid Exchange?
Hyperliquid Exchange is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enables interaction with the hyperliquid exchange to trade perpetuals, check positions, and manage risk through natural language. it provides tools for fetching real-time market data, tracking portfol...
Enables interaction with the Hyperliquid exchange to trade perpetuals, check positions, and manage risk through natural language. It provides tools for fetching real-time market data, tracking portfolio value, and executing orders with a focus on saf
This server falls under the Finance & Fintech category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Enables interaction with the Hyperliquid exchange to trade p
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx hyperliquid-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Hyperliquid Exchange
The Hyperliquid MCP Server is a Python-based integration that allows AI assistants like Claude to interact with the Hyperliquid perpetuals exchange through 27 tools spanning trading, account management, market data retrieval, and real-time WebSocket subscriptions. It enables natural language trading commands such as placing and canceling orders, adjusting leverage, checking positions, and fetching OHLCV candles — all directly from your MCP client. The server connects to Hyperliquid's API using your private key and supports both mainnet and testnet for safe experimentation before live trading.
Prerequisites
- Python 3.8 or higher installed
- A Hyperliquid account with a funded wallet on mainnet or testnet
- Your Hyperliquid wallet private key in 0x... hex format
- Your Hyperliquid account wallet address
- Claude Desktop or another MCP-compatible client
Clone the repository
Clone the Hyperliquid MCP Server repository to your local machine.
git clone https://github.com/caiovicentino/hyperliquid-mcp-server.git
cd hyperliquid-mcp-serverRun the automated setup script
The setup.py script creates a Python virtual environment and installs all dependencies automatically.
python3 setup.pyConfigure the environment file
Create a .env file with your Hyperliquid credentials. Start with testnet to avoid risk while testing. Never share your private key or commit it to version control.
# .env file
HYPERLIQUID_PRIVATE_KEY=0xyour_private_key_here
HYPERLIQUID_ACCOUNT_ADDRESS=0xyour_wallet_address
HYPERLIQUID_NETWORK=testnet
LOG_LEVEL=INFO
RATE_LIMIT_WEIGHT=1200Configure Claude Desktop
Add the server to your Claude Desktop config. Use the absolute path to the virtual environment's Python interpreter and the server's main script.
{
"mcpServers": {
"hyperliquid": {
"command": "/path/to/hyperliquid-mcp-server/venv/bin/python",
"args": ["/path/to/hyperliquid-mcp-server/server.py"],
"env": {
"HYPERLIQUID_PRIVATE_KEY": "0xyour_private_key",
"HYPERLIQUID_ACCOUNT_ADDRESS": "0xyour_address",
"HYPERLIQUID_NETWORK": "testnet"
}
}
}
}Restart Claude Desktop and test on testnet
Restart Claude Desktop to load the server. Test with a small order on testnet before switching HYPERLIQUID_NETWORK to 'mainnet' for live trading.
Hyperliquid Exchange Examples
Client configuration
Claude Desktop configuration for Hyperliquid MCP Server using testnet. Switch HYPERLIQUID_NETWORK to 'mainnet' for live trading.
{
"mcpServers": {
"hyperliquid": {
"command": "/path/to/hyperliquid-mcp-server/venv/bin/python",
"args": ["/path/to/hyperliquid-mcp-server/server.py"],
"env": {
"HYPERLIQUID_PRIVATE_KEY": "0xyour_private_key",
"HYPERLIQUID_ACCOUNT_ADDRESS": "0xyour_wallet_address",
"HYPERLIQUID_NETWORK": "testnet",
"LOG_LEVEL": "INFO"
}
}
}
}Prompts to try
Example trading and analysis prompts to use with the Hyperliquid MCP Server.
- "Show me my current open positions and unrealized PnL"
- "What is the current BTC perpetual price and order book?"
- "Place a limit buy order for 0.01 BTC at $60,000"
- "Set my ETH leverage to 5x"
- "Cancel all open orders for SOL"
- "Show me the funding rate history for BTC over the past 8 hours"Troubleshooting Hyperliquid Exchange
Authentication errors or 'invalid signature' responses from the API
Verify HYPERLIQUID_PRIVATE_KEY starts with '0x' and is the correct key for the account at HYPERLIQUID_ACCOUNT_ADDRESS. Keys must be 64 hex characters after the '0x' prefix. Never use a key from a hardware wallet directly — generate a dedicated API key wallet on Hyperliquid.
Orders fail with 'insufficient margin' errors
Check your account balance and position margin using the 'Show my portfolio value' prompt. On testnet, request test funds from the Hyperliquid testnet faucet. Ensure leverage settings are within your account's allowed range.
Rate limit errors (RATE_LIMIT_WEIGHT)
Reduce the frequency of requests or increase the RATE_LIMIT_WEIGHT value in your .env file (default 1200). Avoid running multiple concurrent queries against market data endpoints in rapid succession.
Frequently Asked Questions about Hyperliquid Exchange
What is Hyperliquid Exchange?
Hyperliquid Exchange is a Model Context Protocol (MCP) server that enables interaction with the hyperliquid exchange to trade perpetuals, check positions, and manage risk through natural language. it provides tools for fetching real-time market data, tracking portfolio value, and executing orders with a focus on saf It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Hyperliquid Exchange?
Follow the installation instructions on the Hyperliquid Exchange GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Hyperliquid Exchange?
Hyperliquid Exchange works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Hyperliquid Exchange free to use?
Yes, Hyperliquid Exchange is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Hyperliquid Exchange Alternatives — Similar Finance & Fintech Servers
Looking for alternatives to Hyperliquid Exchange? Here are other popular finance & fintech servers you can use with Claude, Cursor, and VS Code.
ValueCell
★ 10.7kValueCell is a community-driven, multi-agent platform for financial applications.
Vibe Trading
★ 8.1k'Vibe-Trading: Your Personal Trading Agent'
Quantdinger
★ 6.2kAI quantitative trading platform for crypto, stocks, and forex with backtesting, live trading, market data, and multi-agent research.vibe-trading ,trading-agents,ai-trader,ai-trading
TradingView
★ 2.8kReal-time crypto & stock screening, advanced technical indicators, Bollinger Bands intelligence, candlestick patterns + native Claude Desktop integration. Multi-exchange (Binance, KuCoin, Bybit+). Open-source AI trading infrastructure.
Financial Datasets
★ 2.1kProvides access to comprehensive financial data including income statements, balance sheets, cash flow statements, stock prices, company news, SEC filings, and cryptocurrency information with built-in financial ratio analysis.
Stripe
★ 1.6kThe Stripe Model Context Protocol server allows you to integrate with Stripe APIs through function calling. This protocol supports various tools to interact with different Stripe services.
Browse More Finance & Fintech MCP Servers
Explore all finance & fintech servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Hyperliquid Exchange in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Hyperliquid Exchange?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.