kukapay/hyperliquid-whalealert-mcp

Hyperliquid WhaleAlert MCP

An MCP server that provides real-time whale alerts on Hyperliquid, flagging positions with a notional value exceeding $1 million.

Features

• Tool: get_whale_alerts: Fetches recent whale transactions and returns them as a Markdown table using pandas for clean formatting.
• Prompt: summarize_whale_activity: Generates a summary of whale transactions, including metrics like total position value and notable symbols.

Prerequisites

• Python: Version 3.10 or higher.
• CoinGlass API Key: Obtain from CoinGlass (required for API access).
• uv: Package and dependency manager (install uv).

Installation

1. Clone the Repository:

   git clone https://github.com/kukapay/hyperliquid-whalealert-mcp.git
   cd hyperliquid-whalealert-mcp
   

2. Install Dependencies:

   uv sync
   

   This installs dependencies specified in pyproject.toml.

3. Claude Desktop Integration: Install the server in Claude Desktop:

   uv run mcp install mcp.py --name "Hyperliquid Whale Alert"
   

   Or update the configuration file manually:

   {
     "mcpServers": {
       "hyperliquid-whalealert": {
         "command": "uv",
         "args": [ "--directory", "/path/to/hyperliquid-whalealert-mcp", "run", "main.py" ],
         "env": { "COINGLASS_API_KEY": "your_api_key" }
       }
     }
   }
   

   Replace /path/to/hyperliquid-whalealert-mcp with your actual installation path and COINGLASS_API_KEY with your API key.