Hyperliquid Trader Mcp

Name: Hyperliquid Trader Mcp
Author: patricleehua

@patricleehua

代码仓库

关于 Hyperliquid Trader Mcp

一个封装了hyperliquid交易的mcp工具，可以给模型对hyperliquid进行交易

#dex #trader #hyperliquid

基本信息

分类

其他

传输方式

stdio

发布者

patricleehua

提交者

BingHua Lee

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "Q2h0Fx49bWV0wT0hzIvcA": {
      "name": "hp交易",
      "type": "streamableHttp",
      "description": "",
      "isActive": true,
      "url": "http://0.0.0.0:9000/mcp",
      "installSource": "unknown"
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Hyperliquid Trader Mcp?

A trading toolchain built on the Model Context Protocol (MCP). It wraps commonly used Hyperliquid Python SDK endpoints and exposes them as MCP tools for placing orders, fetching prices, and managing positions/balances on the Hyperliquid DEX.

How to use Hyperliquid Trader Mcp?

Install uv, create a virtual environment, sync dependencies, copy .env.example to .env, and fill in HL_ACCOUNT_ADDRESS, HL_SECRET_KEY, and HL_NETWORK. Run the server with uv run --env-file .env python -m app.mcp_server; optionally specify --transport streamable-http or --transport sse for HTTP/SSE hosting.

Key features of Hyperliquid Trader Mcp

Fetch latest mark price for any symbol.
Place perpetual market or limit orders (buy/sell).
Cancel orders by ID.
Retrieve current positions for perpetual or spot.
Check balances and margin summaries.
Switch between testnet and mainnet via HL_NETWORK.

Use cases of Hyperliquid Trader Mcp

Automating trade execution from an AI assistant.
Monitoring positions and balances programmatically.
Backtesting strategies on testnet before going live.
Integrating Hyperliquid trading commands into custom MCP hosts.

FAQ from Hyperliquid Trader Mcp

What credentials are required?

You need a Hyperliquid API wallet address (HL_ACCOUNT_ADDRESS) and its private key (HL_SECRET_KEY). Use a wallet with trading-only permissions and never commit real keys.

How do I switch between testnet and mainnet?

Set the HL_NETWORK environment variable to testnet or mainnet. Ensure the account address and secret key match the chosen network.

Are spot orders supported?

Spot market and limit order tools exist (place_spot_market, place_spot_limit) but are not yet implemented in the current Hyperliquid SDK; calling them raises NotImplementedError.

What transport options are available?

The server defaults to stdin/stdout. For HTTP/remote access, use --transport streamable-http (default port 8000) or --transport sse (mounts at /sse). Environment variables MCP_TRANSPORT, FASTMCP_HOST, and FASTMCP_PORT are also supported.