Hyperliquid WhaleAlert MCP

Hyperliquid WhaleAlert MCP

Real-time whale alerts and analytics for Hyperliquid with MCP integration

View on GitHub
9
Stars
9
Forks
9
Watchers
1
Issues
Hyperliquid WhaleAlert MCP is an MCP server that delivers real-time notifications and summaries for high-value positions on the Hyperliquid exchange, specifically flagging positions exceeding $1 million in notional value. It provides tools to fetch recent whale transactions in a well-formatted Markdown table and prompts to generate comprehensive analytical summaries of whale activity. Designed for seamless integration with Claude Desktop and AI model context handling protocols, it utilizes the CoinGlass API and Python 3.10+. The toolset enhances oversight and analysis of significant trading activities for users and LLM-integrated applications.

Key Features

MCP server implementation
Real-time whale alert detection
Markdown-formatted whale activity tables
Prompt-based summary generation
Integration with Claude Desktop
Configurable API key support
Python 3.10+ compatibility
Automated tool and prompt exposure to LLMs
Dependency management with uv
Customizable through environment variables

Use Cases

Monitoring large trades on the Hyperliquid exchange
Flagging positions exceeding a specified notional threshold
Generating summaries of whale trading activity for analysts
Integrating real-time whale alerts into trading dashboards
Providing structured whale data for AI language models
Supporting quantitative research on large crypto movements
Enabling end-users to receive significant trade notifications
Augmenting compliance or risk analysis tools
Supplying whale analytics in educational or reporting contexts
Enriching chatbot or assistant platforms with live crypto transaction data

README

Hyperliquid WhaleAlert MCP

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

GitHub License Python Version Status

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:

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

  2. Install Dependencies:

    bash
    uv sync

    This installs dependencies specified in pyproject.toml.

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

    bash
    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.

Usage

Using the Tool

The get_whale_alerts tool fetches whale transaction data and returns it as a Markdown list. Example output:

markdown
- **ETH Transaction**:
  - User Address: 0x3fd4444154242720c0d0c61c74a240d90c127d33
  - Position Size: 12700
  - Entry Price: $1611.62
  - Liquidation Price: $527.2521
  - Position Value (USD): $21003260
  - Action: Close
  - Create Time: 2025-05-20 12:31:57
- **BTC Transaction**:
  - User Address: 0x1cadadf0e884ac5527ae596a4fc1017a4ffd4e2c
  - Position Size: 33.54032
  - Entry Price: $87486.2
  - Liquidation Price: $44836.8126
  - Position Value (USD): $2936421.4757
  - Action: Close
  - Create Time: 2025-05-20 12:31:17

To invoke the tool:

  • In the MCP Inspector, select get_whale_alerts and execute.
  • In Claude Desktop, use the registered server and call the tool via the UI or API.

Using the Prompt

The summarize_whale_activity prompt generates a summary of whale transactions. Example interaction (in a compatible client):

plaintext
/summarize_whale_activity

Response:

I'll analyze the whale transaction data and provide a summary.

This can be extended by LLMs to provide detailed metrics like total position value or notable symbols.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Star History

Star History Chart

Repository Owner

kukapay
kukapay

User

Repository Details

Language Python
Default Branch main
Size 17 KB
Contributors 1
License MIT License
MCP Verified Nov 12, 2025

Programming Languages

Python
100%

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • Whale Tracker MCP Server

    Whale Tracker MCP Server

    Monitor and analyze large cryptocurrency transactions using MCP and Whale Alert API integration.

    Whale Tracker MCP Server implements the Model Context Protocol to provide real-time monitoring and analysis of large-scale cryptocurrency transactions. Built in Python, it integrates seamlessly with the Whale Alert API and exposes tools, resources, and prompt templates to MCP-compatible clients such as Claude Desktop. This solution enables users to fetch recent whale transactions, retrieve detailed information, and leverage contextual data directly within their LLM-powered workflows.

    • ⭐ 44
    • MCP
    • kukapay/whale-tracker-mcp
  • Web3 Jobs MCP Server

    Web3 Jobs MCP Server

    AI-ready MCP server delivering curated, real-time Web3 job listings.

    Web3 Jobs MCP Server provides real-time access to curated Web3 job listings from web3.career through a Model Context Protocol (MCP) interface, enabling intelligent job discovery for AI agents. The server supports advanced filtering by location, remote status, job tag, and result limits, and returns results in Markdown format. It enables the generation of natural language prompts for job searches, facilitating seamless integration with AI platforms such as Claude Desktop. Designed for Python 3.10+, it offers flexible deployment and configuration options.

    • ⭐ 4
    • MCP
    • kukapay/web3-jobs-mcp
  • Coincap MCP

    Coincap MCP

    Query live cryptocurrency data through Coincap's public API for desktop AI tools.

    Coincap MCP provides seamless access to cryptocurrency market data from Coincap's public API without requiring API keys or registration. Designed to integrate with Claude Desktop using the Model Context Protocol (MCP), it enables users to query crypto asset prices, market capitalization, and a list of available assets. Installation and configuration are streamlined through Smithery or direct setup. The tool includes sample prompts and exposes specialized tools for crypto price lookup and asset listing.

    • ⭐ 89
    • MCP
    • QuantGeekDev/coincap-mcp
  • mcp-server-ledger

    mcp-server-ledger

    Model Context Protocol server for interacting with Ledger CLI via AI assistants.

    mcp-server-ledger provides a standardized Model Context Protocol interface for the Ledger CLI, enabling AI-driven querying and analysis of double-entry accounting data. It exposes key Ledger CLI commands as tools accessible by Large Language Models for financial reporting, budget analysis, and account management. It supports deployment via Docker, Smithery, or 'uv', and requires a valid ledger file and appropriate environment setup.

    • ⭐ 35
    • MCP
    • minhyeoky/mcp-server-ledger
  • PumpSwap MCP Server

    PumpSwap MCP Server

    MCP server for real-time Solana token trades and pool data.

    PumpSwap MCP Server allows AI agents to interact with the PumpSwap DEX on Solana for automated, real-time token swaps and on-chain trading operations. It exposes commands for buying and selling tokens, querying token prices, and retrieving liquidity pool information. Designed for secure integration with Solana accounts, it enables customizable slippage and transaction fees while supporting context-driven, AI-issued commands. The server operates as a bridge between AI agents and the PumpSwap protocol, facilitating seamless trading and data queries.

    • ⭐ 5
    • MCP
    • kukapay/pumpswap-mcp
  • PancakeSwap PoolSpy MCP Server

    PancakeSwap PoolSpy MCP Server

    Real-time tracking of new PancakeSwap pools for DeFi analytics.

    PancakeSwap PoolSpy MCP Server provides a Model Context Protocol-compatible service for monitoring newly created liquidity pools on PancakeSwap. It offers real-time analytics including pool address, tokens, creation timestamp, volume, and total value locked. Users can customize queries for time range and results count, making it valuable for traders, analysts, and developers seeking up-to-date DeFi insights. The server is designed for easy deployment and integration via Smithery or manual setup.

    • ⭐ 6
    • MCP
    • kukapay/pancakeswap-poolspy-mcp
    • View all Alternatives

    Didn't find tool you were looking for?

    Be as detailed as possible for better results