HYPERLIQUID-MCP-Server by 6rz6 - MCP Server

title: Hyperliquid MCP Server & Trading Dashboard emoji: 📊 colorFrom: blue colorTo: green sdk: docker pinned: false

🚀 Hyperliquid MCP Server & Trading Dashboard

A production-ready Model Context Protocol (MCP) server with an interactive Gradio dashboard providing real-time trading data from Hyperliquid - the leading decentralized perpetual exchange.

🌐 Live Demo

URL: https://huggingface.co/spaces/rzvn/hyperliquid-mcp-server

🎯 Features

✅ MCP Server

8 Trading Tools with RESTful API
Model Context Protocol compliance
Real-time data from Hyperliquid

✅ Interactive Dashboard

5 Interactive Tabs with live data
Real-time charts and visualizations
User-friendly interface for all tools

📊 Available Trading Tools

1. Market Prices 📈

Get real-time prices for 200+ trading pairs

Live price feed
Top 20 by value
Interactive data table

2. Recent Trades 💱

View recent trading activity

Customizable trade count (1-1000)
Real-time trade history
Symbol-based filtering

3. Candlestick Charts 📊

Interactive price charts

Multiple timeframes (1m, 5m, 1h, 4h, 1d)
Customizable candle count
Professional charting with Plotly

4. Order Book 📋

Live order book visualization

Bid/ask depth charts
Real-time updates
Symbol-based lookup

5. Funding Rates 💰

Perpetual contract funding rates

All markets overview
Individual symbol focus
Historical rate tracking

🔧 API Usage

MCP Endpoints

Health Check: GET /health
List Tools: POST /mcp/tools
Execute Tool: POST /mcp/call

Example API Calls

Get All Market Prices

curl -X POST https://rzvn-hyperliquid-mcp-server.hf.space/mcp/call \
  -H "Content-Type: application/json" \
  -d '{"name": "get_all_mids", "arguments": {}}'

Get Recent BTC Trades

curl -X POST https://rzvn-hyperliquid-mcp-server.hf.space/mcp/call \
  -H "Content-Type: application/json" \
  -d '{"name": "get_recent_trades", "arguments": {"coin": "BTC", "n": 50}}'

🖥️ Interactive Dashboard Usage

Dashboard Tabs

📈 Market Prices Tab

Click "Get All Market Prices" to load live data
View top 20 cryptocurrencies by price
Interactive sorting and filtering

💱 Recent Trades Tab

Enter coin symbol (e.g., "BTC", "ETH")
Adjust number of trades with slider
View detailed trade history table

📊 Candlestick Charts Tab

Enter coin symbol
Select timeframe (1m to 1d)
Adjust number of candles
Interactive zoom and pan

📋 Order Book Tab

Enter coin symbol
View live bid/ask depth
Visual order book representation

💰 Funding Rates Tab

Optional coin symbol input
View all funding rates or specific symbol
Real-time rate updates

🛠️ Development

Local Setup

# Clone the repository
git clone https://huggingface.co/spaces/rzvn/hyperliquid-mcp-server
cd hyperliquid-mcp-server

# Install dependencies
pip install -r requirements.txt

# Run locally
python app.py

Access Points

Gradio Dashboard: http://localhost:7860
MCP API: http://localhost:3001

Docker Build

docker build -t hyperliquid-mcp .
docker run -p 7860:7860 -p 3001:3001 hyperliquid-mcp

🔗 MCP Integration

This server follows the Model Context Protocol (MCP) standard, making it compatible with:

Claude Desktop
Cursor AI
Any MCP-compatible client
Custom applications

📈 Data Coverage

200+ Trading Pairs: All major cryptocurrencies and altcoins
Real-time Data: Live prices, trades, and order books
Historical Data: Candlestick charts with multiple timeframes
Perpetual Contracts: Funding rates and open interest
Account Analytics: Portfolio tracking and position management

🎯 Use Cases

For Traders

Real-time market monitoring
Technical analysis with charts
Order book analysis
Funding rate tracking

For Developers

MCP server integration
RESTful API access
Real-time data feeds
Trading bot development

For Analysts

Market research
Historical data analysis
Trading strategy backtesting
Market sentiment analysis

🤝 Contributing

Feel free to open issues or submit pull requests to enhance the server with additional Hyperliquid endpoints or features.

📄 License

MIT License - Feel free to use this server for your own projects and applications.