Whale Tracker MCP

What kukapay/whale-tracker-mcp MCP server does

The kukapay/whale-tracker-mcp MCP server exposes Whale Alert data to MCP-compatible applications. It is intended for workflows that need to inspect large cryptocurrency movements, filter recent activity, or examine an individual transaction in more detail.

The server supports two primary data operations. Recent transactions can be requested with optional blockchain, minimum-value, and result-limit filters. A separate operation retrieves detailed information for a transaction when its ID is known.

It also defines a resource at whale://transactions/{blockchain}. This resource supplies recent transaction data for a named blockchain as context. The query_whale_activity prompt provides a reusable way to ask for analysis of whale activity, optionally scoped to a blockchain.

How it works

At startup, the application loads WHALE_ALERT_API_KEY from the environment. A .env file is supported through python-dotenv. When a client invokes a tool or uses the blockchain resource, the server makes asynchronous HTTP requests to Whale Alert with httpx and returns the resulting data to the MCP client.

The repository contains a Python entry point named whale_tracker.py. It can be launched directly with Python, run through the MCP CLI, or installed into Claude Desktop with the MCP installation command. The README documents Claude Desktop and MCP Inspector as compatible ways to interact with the server.

Setup and configuration

Python 3.10 or newer is required. Clone the repository, install mcp, httpx, and python-dotenv, then provide a Whale Alert API key. The expected environment variable is:

WHALE_ALERT_API_KEY=your_api_key_here

The key can be placed in a .env file in the project directory. It can also be supplied with the MCP CLI when installing the server into Claude Desktop. After installation, restart Claude Desktop and verify that the server's tools are available through the hammer icon.

For local execution, the documented command is:

python whale_tracker.py

The repository also documents mcp run whale_tracker.py and an MCP Inspector development command for testing the server interactively.

Tools and capabilities

The kukapay/whale-tracker-mcp MCP server exposes:

• get_recent_transactions for recent whale transfers, with optional blockchain, minimum-value, and limit filters.
• get_transaction_details for looking up a transaction by ID.
• whale://transactions/{blockchain} for recent blockchain-specific transaction context.
• query_whale_activity for a reusable analysis prompt, optionally filtered by blockchain.
• Asynchronous API access implemented with httpx.

Limitations and notes

The kukapay/whale-tracker-mcp MCP server depends on the Whale Alert API and therefore requires a valid Whale Alert API key. The supplied material does not specify API quotas, supported blockchain names, historical-retention limits, or whether the API key is free or paid. The server is a data-access and analysis interface; the README does not describe trading, alert delivery, portfolio management, or transaction execution features.

The documented client integration is Claude Desktop, while MCP Inspector is described for development and testing. No support for Cursor, Windsurf, or Cline is stated in the supplied material.