Hyperliquid MCP

Agent quickstart

Add Hyperliquid from https://hyperliquid.tendle.ai

Related MCP server: LiquidVision MCP server

Try asking

• “Find Anthropic and OpenAI markets. Show their collateral and leverage limits.”

• “How much of my balance is available, and how much is held?”

• “Show my positions and open orders on the xyz deployment.”

• “Check my trading capacity before placing an order.”

What it covers

Discover and trade default perpetuals, builder/HIP-3 perpetuals, and spot markets. Search uses live market names and upstream keywords, including pre-IPO categories.

All 30 tool names begin with hyperliquid_. Live docs contain the current inputs and behavior; tools/list supplies the schemas.

Connect a wallet

Initialization, tool discovery, hyperliquid_get_docs, and hyperliquid_generate_wallet work without credentials. Other tools require Authorization: Bearer <credential>. Use the client's secure credential settings, not prompts or URLs. An invalid supplied credential is rejected even on public tools.

• Private key: 64 hexadecimal characters, optionally prefixed with 0x.

• Seed phrase: a valid English 12- or 24-word BIP-39 phrase. The agent lists accounts with hyperliquid_list_wallet_accounts, asks you to choose, and passes the selected {index,address} as walletAccount on subsequent authenticated calls.

Keys are request-scoped and are not persisted by the server. Wallet generation returns an address, private key, and seed phrase. Both secrets are visible to the tool caller and must be saved securely by the client.

Phrase discovery uses m/44'/60'/0'/0/index, ten accounts per page, with no extra passphrase. Addresses may be unused. Other derivation paths or passphrases require an individual private key. Normalize phrase whitespace to single spaces in headers. The pinned eth-account library marks its HD-wallet API as unaudited.

X-Hyperliquid-Account-Address and X-Hyperliquid-Vault-Address select existing exchange-authorized contexts. userAddress selects the subject of a read, not a signer. Collateral transfers, account-mode changes, deposits, and withdrawals require owner keys without account/vault overrides.

Clients migrating from the old Tendle endpoint must update their credential host as well as their MCP URL. Muse requires secure credential re-entry for that change.

Before trading

The hosted connector uses mainnet.

• Query fresh state. Total balance is not available collateral. Account responses separate held, unheld, and available-after-maintenance amounts; unknown availability is null. Positions cover the selected deployment.

• Use the discovered market ID. Check market_details with account information for that market's trading capacity. Similar symbols can identify different assets.

• Verify writes. Partial or uncertain outcomes need fresh reads, not a repeated order. A submitted withdrawal is not proof of receipt.

• Bridge requirements: legacy deposits need at least 5 USDC and Arbitrum ETH for gas. Arbitrum confirmation does not prove Hyperliquid credit. CCTP is not implemented.

Run locally

Requires Python 3.11+ and uv.

uv sync --frozen
uv run hyperliquid-mcp

The local default is testnet, at http://127.0.0.1:8001/mcp. See .env.example for settings and export them in your shell; the application does not automatically load .env. Network selection is server-wide.

uv run pytest -q
uv run ruff check --no-cache .
uv run ruff format --check --no-cache .

Tests intercept exchange HTTP calls, including real SDK signing. They do not prove live transaction settlement. Muse installation and authenticated reads have also been verified against the hosted service.

Use HTTPS, keep credentials out of logs, and install runtime dependencies with uv sync --frozen --no-dev. Run one application process: signer coordination is in-process, so multiple workers need shared coordination to prevent nonce collisions.

The manifest describes the Tendle-hosted service. Update its URLs for your own instance. Deployment infrastructure is maintained separately.

Credits

Adapted from edkdev/hyperliquid-mcp at commit 7f3965182f50f28f7a22cbc8f93e5bf0a0439f14. MIT license. Support.