HYPERLIQUID

Hyperliquid MCP Server is a production-ready MCP server that exposes real-time Hyperliquid trading data through a RESTful API and an interactive Gradio dashboard. It provides eight trading tools such as Market Prices, Recent Trades, Candlestick Charts, Order Book, and Funding Rates, all accessible via standardized MCP endpoints. You can query the server to fetch live prices, recent trades, or chart data, and you can interact with the Gradio dashboard to visualize data and run tool actions in real time. The MCP endpoints include a health check, a tool listing, and an execute tool call, enabling integration with external clients and automation workflows.

To use the server, ensure the Docker image hyperliquid-mcp is running. The Gradio dashboard is exposed locally on port 7860, and the MCP API endpoints are exposed on port 3001. You can call the endpoints to retrieve data or use the dashboard to interact with the available tools, such as loading live market prices, filtering recent trades by symbol, or displaying candlestick charts across multiple timeframes.

Prerequisites:

• Docker installed on your machine (Docker Desktop for Windows/macOS or Docker Engine on Linux)
• Access to the internet to pull the image hyperliquid-mcp

Installation steps:

1. Pull and run the Docker image: docker run -p 7860:7860 -p 3001:3001 hyperliquid-mcp

2. Verify the server is up:

   • MCP API health endpoint: http://localhost:3001/health
   • Gradio dashboard: http://localhost:7860

3. If you need to build the image locally, you can clone the repo (if available) and build using: docker build -t hyperliquid-mcp . docker run -p 7860:7860 -p 3001:3001 hyperliquid-mcp

4. Optional: configure environment variables or volumes as needed for your deployment environment (see notes).

Tips and caveats:

• The MCP API uses POST requests to /mcp/call to execute tools. Use the provided examples as references for payload structure (name and arguments).
• The Gradio dashboard exposes multiple tabs (Market Prices, Recent Trades, Candlestick Charts, Order Book, Funding Rates). You can load live data by triggering the corresponding tool in the UI.
• If you run into port conflicts, adjust the -p mappings in the docker run command accordingly and ensure the host ports 7860 and 3001 are free.
• For production deployments, consider binding to a reverse proxy and enabling proper rate limits and authentication depending on your use case.
• This server is Docker-based in the provided configuration; if you need to run via other runtimes, you may adapt the mcp_config accordingly (e.g., npx, python modules) if a compatible image or entrypoint is available.