🚀 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

🚀 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:

1. Set PAPER_TRADING=false

2. Set HL_TESTNET=false for mainnet

3. Make sure HL_PRIVATE_KEY is set

4. 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)

🗺️ Roadmap

• Historical trade data tool

• Portfolio P&L over time

• Multi-account support

• Telegram bot integration

• Strategy backtesting tool

• Automated rebalancing agent

📄 License

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

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