Overview
Whale Tracker MCP Server is a Python-based implementation of the Model Context Protocol (MCP) that integrates with the Whale Alert API to enable real-time tracking and analysis of large cryptocurrency transactions. It exposes MCP-compatible Tools, Resources, and Prompts that can be consumed by MCP clients like Claude Desktop or the MCP Inspector, providing a streamlined interface for monitoring whale activity within LLM-powered workflows. Core Tools include get_recent_transactions, which fetches recent whale movements with optional filters for blockchain, minimum value, and result limits, and get_transaction_details, which retrieves detailed information about a specific transaction by ID. The server also exposes a contextual data resource whale://transactions/{blockchain}, surfacing blockchain-specific whale activity. A reusable prompt, query_whale_activity, supports analyzing patterns and trends, optionally filtered by blockchain. It uses httpx for asynchronous HTTP calls to Whale Alert and supports API key management via a .env file (WHALE_ALERT_API_KEY) with python-dotenv. Installation and development guidance leverage Smithery for Claude Desktop deployment and MCP development workflows.
Features
get_recent_transactions
Fetch recent whale transactions with optional filters for blockchain, minimum value, and limit.
get_transaction_details
Retrieve detailed information about a specific transaction by its ID.
whale data resource
Expose recent transactions for a specified blockchain as contextual data via whale://transactions/{blockchain}.
query_whale_activity
A reusable template for analyzing whale transaction patterns, optionally filtered by blockchain.
Asynchronous API calls
Uses httpx to perform non-blocking requests to Whale Alert API.
Environment variable API key support
Securely manage your Whale Alert API key via a .env file (WHALE_ALERT_API_KEY) with python-dotenv.
MCP client compatibility
Designed to work with MCP clients like Claude Desktop or the MCP Inspector, enabling seamless integration.
Smithery-based installation
Includes Smithery-based installation workflow for deploying to Claude Desktop.
Who Is This For?
- MCP users:Integrate whale transaction tracking into MCP workflows (e.g., Claude Desktop, MCP Inspector) for real-time insights.
- Cryptocurrency analysts:Monitor large transfers and analyze whale activity within LLM-powered analyses.
- Developers:Build MCP-enabled apps by integrating tools, resources, and prompts provided by the server.
