# kukapay/whale-tracker-mcp [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/kukapay/whale-tracker-mcp  
**GitHub Stars:** 56  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/kukapay-whale-tracker-mcp

## Description
A mcp server for tracking cryptocurrency whale transactions.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "whale-tracker-mcp": {
    "command": "npx",
    "args": ["-y","@smithery/cli"],
    "env": {
      "WHALE_ALERT_API_KEY": ""
    }
  }
}
```

**Requires environment variables:** `WHALE_ALERT_API_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## 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:

```text
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:

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

_Full upstream README: https://allmcps.com/mcp/kukapay-whale-tracker-mcp/readme_