🚀 Hyperliquid MCP Server

The first MCP server for Hyperliquid — trade perps, check positions, and manage risk via natural language in Claude, ChatGPT, or any MCP-compatible AI agent.

⚡ What You Can Do

Ask Claude in plain English:

"What's my Hyperliquid portfolio worth?" "Show me my open positions and unrealized PnL" "What's the order book for ETH perp right now?" "Which perps have negative funding I can take advantage of?" "How far am I from liquidation on my BTC long?" "Paper trade: buy 0.1 ETH at market" "Set a stop-loss on my SOL position at $120"

🛠️ Tools

Tool	Description
`get_portfolio_value`	Account balance, equity, margin, unrealized PnL
`get_positions`	All open perp positions with PnL and leverage
`get_orderbook`	Live bid/ask for any market
`get_funding_rates`	Current + predicted funding across all perps
`get_liquidation_price`	Distance from liquidation for each position
`place_order`	Market or limit order (paper trading by default)
`cancel_order`	Cancel one or all open orders
`set_stop_loss`	Set a reduce-only stop-loss trigger

🚀 Quick Start

1. Clone + Install

git clone https://github.com/YOUR_USERNAME/hyperliquid-mcp
cd hyperliquid-mcp
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt

2. Configure

cp .env.example .env
# Edit .env with your wallet address
# Leave PAPER_TRADING=true until you're ready for live trading

3. Connect to Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "hyperliquid": {
      "command": "python",
      "args": ["/absolute/path/to/hyperliquid-mcp/server.py"],
      "env": {
        "HL_WALLET_ADDRESS": "0xYOUR_WALLET_ADDRESS",
        "HL_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY",
        "HL_TESTNET": "true",
        "PAPER_TRADING": "true"
      }
    }
  }
}

Restart Claude Desktop. You'll see 🔨 tools available in the input bar.

⚠️ Safety

PAPER_TRADING=true by default. In paper trading mode, all orders are logged but NEVER submitted to Hyperliquid. Safe for testing.

To enable live trading:

Set PAPER_TRADING=false
Set HL_TESTNET=false for mainnet
Make sure HL_PRIVATE_KEY is set
Understand: real money is at risk

The server will always show [PAPER TRADING] or [TESTNET] in tool descriptions so you know which mode you're in.

Never commit your private key. .env is in .gitignore by default.

💰 Monetization (for the managed version)

Tier	Price	Features
Open Source	Free	Self-hosted, all tools
Cloud Hosted	$29/mo	We host it, no setup, auto-updates
Pro Templates	$97 one-time	Strategy templates + backtesting prompts
Custom Bot	$500–$2,000	Done-for-you custom trading agent

🗺️ Roadmap

📄 License

MIT — use it, fork it, build on it.

Built by AgentReady — making businesses and markets AI-agent ready.

Hyperliquid MCP Server