Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Hyperliquid MCP place a limit buy order for 0.1 ETH perp at $3000"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Add Hyperliquid from https://hyperliquid.tendle.aiRelated MCP server: trade-router-mcp
“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.”
Discover and trade default perpetuals, builder/HIP-3 perpetuals, and spot markets. Search uses live market names and upstream keywords, including pre-IPO categories.
Workflow | Tools |
Wallet setup |
|
Markets |
|
Account |
|
Orders |
|
Margin & collateral |
|
Bridge |
|
Vaults |
|
Reference |
|
All 30 tool names begin with hyperliquid_. Live docs
contain the current inputs and behavior; tools/list supplies the schemas.
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.
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.
Requires Python 3.11+ and uv.
uv sync --frozen
uv run hyperliquid-mcpThe 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.
Path | Contents |
| MCP server, authentication, tool schemas, and exchange operations |
| Behavior and integration tests |
| Connector manifest and icon |
| Package configuration and locked dependencies |
The manifest describes the Tendle-hosted service. Update its URLs for your own instance. Deployment infrastructure is maintained separately.
Adapted from edkdev/hyperliquid-mcp
at commit 7f3965182f50f28f7a22cbc8f93e5bf0a0439f14.
MIT license. Support.
This server cannot be deployed
Swap quotes + unsigned txs on 8 EVM chains, plus Solana data: boards, candles, wallet PnL. No key.
Non-custodial Hyperliquid perp trading: live markets, account state, user-armed order execution
Read-only access to Floatout plans, launch guides and fee research for branded Hyperliquid perpetuals and prediction market DEXs. No API key required. Documentation: https://docs.floatout.xyz
Cross-network DeFi API data, AMM analytics, and SDK docs for 17+ networks.
