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

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)

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

• [ ] 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.