Model Context Protocol server for Hyperliquid trading using the official Python SDK
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"mcp-hyperliquid","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# Hyperliquid MCP Server A Model Context Protocol (MCP) server for Hyperliquid perpetual trading using the official Python SDK. This server provides AI assistants with secure, reliable access to Hyperliquid's trading platform. ## Features ✅ **Official SDK** - Built on the official Hyperliquid Python SDK with proper signing ✅ **Complete Coverage** - All trading endpoints: orders, positions, market data, vaults ✅ **Secure** - Proper EIP-712 signing with agent mode support ✅ **Bracket Orders** - Atomic entry + TP + SL order placement ✅ **Market Data** - Real-time prices, order books, funding rates, candles ✅ **Account Management** - Positions, balances, fills, funding history ✅ **Testnet Support** - Test strategies safely before going live ## Prerequisites - Python 3.10 or higher - [uv](https://github.com/astral-sh/uv) or [uvx](https://github.com/astral-sh/uv) for package management - A Hyperliquid account with deposited funds ## Installation ### Using uvx (Recommended) ```bash # Install and run directly uvx hyperliquid-mcp ``` ### Using uv ```bash # Clone and install cd hyperliquid-mcp uv sync # Run uv run hyperliquid-mcp ``` ### Traditional pip ```bash pip install hyperliquid-mcp hyperliquid-mcp ``` ## Configuration ### 1. Register Your Wallet on Hyperliquid **IMPORTANT:** Your wallet must be registered on Hyperliquid before trading. **Mainnet:** 1. Go to https://app.hyperliquid.xyz 2. Connect your wallet 3. Deposit funds from Arbitrum One (any amount registers your wallet) **Testnet:** 1. Go to https://app.hyperliquid-testnet.xyz 2. Connect your wallet 3. Get testnet funds from the faucet or bridge ### 2. Configure Your MCP Client Environment variables are now configured directly in your MCP client settings (no `.env` file needed). #### Claude Desktop / Kiro Add to your `mcp.json` configuration file: ```json { "mcpServers": { "hyperliquid": { "command": "uvx", "args": ["hyperliquid-mcp"], "env": { …
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.