Hyperliquid Trader MCP Server

@patricleehua

Basic information

About Hyperliquid Trader MCP Server

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

Hyperliquid Trader MCP Server config

Add this server to your MCP-compatible client using the configuration below.

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

Hyperliquid Trader MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list directly from this server's endpoint using the button above.

Overview

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.

Frequently asked questions

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.

How should I handle rate limits or timeouts?

Add retry or rate‑limit logic inside `HLClient`. Always test on testnet first before switching to mainnet.

Comments

More Other MCP servers

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K

The Living Bread

A free remote MCP server for The Living Bread. Bible passages read word for word from a stored public domain text with an evidence label, keyword search and cross references, real churches, gatherings and prayer groups w

Hindsight

vectorize-io

Hindsight: Agent Memory That Learns

50.4K

PickFu MCP

PickFu MCP is a Model Context Protocol (MCP) server that connects AI assistants, developers, marketers, product managers, and AI agents to PickFu's consumer research platform. It enables users to create surveys, conduct

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.