Whale Tracker MCP Server

Finance & FintechPython

Track and analyze cryptocurrency whale transactions in real-time

Available Tools

get_recent_transactions

Fetch recent whale transactions with optional filters for blockchain, minimum value, and limit

blockchainmin_valuelimit

get_transaction_details

Retrieve detailed information about a specific transaction by its ID

transaction_id

Whale Tracker provides real-time monitoring and analysis of large cryptocurrency transactions (known as "whale" movements) by integrating with the Whale Alert API. This tool enables cryptocurrency enthusiasts, traders, and analysts to stay informed about significant market movements that could impact cryptocurrency prices. With Whale Tracker, you can fetch recent whale transactions with customizable filters for specific blockchains, minimum transaction values, and result limits. The server also allows you to retrieve detailed information about specific transactions by their ID, making it easy to investigate notable market activities.

Getting Started with Whale Tracker

Whale Tracker is a powerful tool for monitoring large cryptocurrency transactions ("whale movements") that could potentially impact market prices. This guide will help you set up and use the Whale Tracker MCP server effectively.

Prerequisites

Before installing Whale Tracker, ensure you have:

Python 3.10 or higher installed on your system
A Whale Alert API key (sign up at whale-alert.io)
An MCP-compatible client like Claude Desktop

Installation Options

Option 1: Install via Smithery (Recommended)

The easiest way to install Whale Tracker is through Smithery:

npx -y @smithery/cli install @kukapay/whale-tracker-mcp --client claude

Option 2: Manual Installation

Clone the repository:

git clone https://github.com/kukapay/whale-tracker-mcp.git
cd whale-tracker-mcp

Install dependencies using uv (recommended) or pip:

# Using uv
uv add "mcp[cli]" httpx python-dotenv

# Using pip
pip install mcp httpx python-dotenv

Create a .env file in the project root with your API key:

WHALE_ALERT_API_KEY=your_api_key_here

Install the server into Claude Desktop:

mcp install whale_tracker.py --name "WhaleTracker" -f .env

Restart Claude Desktop to complete the installation.

Using Whale Tracker

Once installed, you can interact with Whale Tracker in your MCP-compatible client using natural language. Here are some example queries:

"Show me recent whale transactions on Bitcoin"
"What are the latest Ethereum transactions over $5 million?"
"Get details for transaction ID 123456789"
"Analyze whale activity on Tether in the last 24 hours"

Development and Testing

To run the server in development mode with the MCP Inspector:

mcp dev whale_tracker.py --with-editable .

This opens a web interface where you can explore and test the server's tools, resources, and prompts.

API Key Management

Your Whale Alert API key is required for the server to function. You can configure it in several ways:

Create a .env file with WHALE_ALERT_API_KEY=your_key_here
Pass it directly when installing: mcp install whale_tracker.py -v WHALE_ALERT_API_KEY=your_key_here
Set it as an environment variable in your system

Troubleshooting

If you encounter rate limiting issues, consider upgrading your Whale Alert API plan
For connection problems, check your internet connection and firewall settings
If the server doesn't appear in Claude Desktop, ensure you've restarted the application after installation