🔮 Hyperliquid MCP Server

The first MCP server for DeFi perpetual futures trading. Let AI agents trade on Hyperliquid — the #1 decentralized derivatives exchange ($50B+ weekly volume).

Trade perps, check positions, manage risk — all through natural language via Claude, GPT, or any MCP-compatible AI agent.

⚡ Features

🚀 Quick Start

1. Install

pip install -e .

Or install dependencies directly:

pip install "mcp[server]" hyperliquid-python-sdk python-dotenv

2. Configure

cp .env.example .env

Edit .env:

HYPERLIQUID_PRIVATE_KEY=your_private_key_here
HYPERLIQUID_WALLET_ADDRESS=0xYourAddress
HYPERLIQUID_TESTNET=true

⚠️ Start with testnet! Set HYPERLIQUID_TESTNET=true for paper trading.

3. Run

hyperliquid-mcp
# or
python -m hyperliquid_mcp.server

🤖 Claude Desktop Configuration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "hyperliquid": {
      "command": "python",
      "args": ["-m", "hyperliquid_mcp.server"],
      "cwd": "/path/to/hyperliquid-mcp",
      "env": {
        "HYPERLIQUID_PRIVATE_KEY": "your_key",
        "HYPERLIQUID_WALLET_ADDRESS": "0xYourAddress",
        "HYPERLIQUID_TESTNET": "true"
      }
    }
  }
}

Or if installed via pip:

{
  "mcpServers": {
    "hyperliquid": {
      "command": "hyperliquid-mcp",
      "env": {
        "HYPERLIQUID_PRIVATE_KEY": "your_key",
        "HYPERLIQUID_WALLET_ADDRESS": "0xYourAddress",
        "HYPERLIQUID_TESTNET": "true"
      }
    }
  }
}

💬 Example Prompts

Once connected, try asking your AI agent:

• "What's the current BTC funding rate on Hyperliquid?"

• "Show me the ETH orderbook, top 5 levels"

• "Set leverage to 5x on SOL and buy 10 SOL at market"

• "What are my open positions and total PnL?"

• "Close my ETH position at market price"

• "List all available markets and their max leverage"

🔒 Security

• Never commit your .env file — it contains your private key

• Start with testnet — always test with paper money first

• Review orders before confirming — AI agents can make mistakes

• Private keys are only used locally — never transmitted except to Hyperliquid's API

📋 Requirements

• Python 3.10+

• A Hyperliquid wallet (testnet or mainnet)

• An MCP-compatible client (Claude Desktop, etc.)

License

MIT