Whale Tracker MCP Server

What is Whale Tracker MCP Server?

A Python-based Model Context Protocol (MCP) server that integrates with the Whale Alert API to enable real‑time tracking and analysis of large cryptocurrency transactions (“whale” movements). Designed for cryptocurrency enthusiasts, developers, and analysts who want to monitor whale activity within LLM‑powered workflows.

How to use Whale Tracker MCP Server?

Install via Smithery or clone the repository, install dependencies (mcp[cli], httpx, python-dotenv), and configure a Whale Alert API key in a .env file. Run in development mode with mcp dev whale_tracker.py, integrate with Claude Desktop using mcp install whale_tracker.py --name "WhaleTracker" -f .env, or execute directly with python whale_tracker.py. Available tools include get_recent_transactions, get_transaction_details; resources include whale://transactions/{blockchain}; and the query_whale_activity prompt template.

Key features of Whale Tracker MCP Server

• Tools for fetching recent whale transactions with optional filters
• Tool for retrieving detailed transaction information by ID
• Resource exposing recent transactions per blockchain
• Reusable prompt template for analyzing whale activity
• Asynchronous API calls using httpx
• Secure API key management via environment variables

Use cases of Whale Tracker MCP Server

• Fetch latest whale transactions on a specific blockchain (e.g., Ethereum) with a minimum value
• Get detailed information about a particular cryptocurrency transaction
• Analyze recent whale activity on Bitcoin using the built‑in prompt template

FAQ from Whale Tracker MCP Server

What prerequisites are needed to run the server?

Python 3.10 or higher, a Whale Alert API key (sign up at whale‑alert.io), and an MCP‑compatible client such as Claude Desktop or the MCP Inspector.

How do I configure the Whale Alert API key?

Create a .env file in the project root with WHALE_ALERT_API_KEY=your_api_key_here. The server loads the key automatically at startup. Alternatively, pass the key directly with mcp install -v WHALE_ALERT_API_KEY=your_api_key_here.

What tools does the server expose?

Two tools: get_recent_transactions (fetch recent whale transactions with optional blockchain, minimum value, and limit filters) and get_transaction_details (retrieve details for a specific transaction ID).

Can I use the server without Claude Desktop?

Yes. Run the server standalone with python whale_tracker.py or mcp run whale_tracker.py, and test it using the MCP Inspector via mcp dev whale_tracker.py.

Where does the transaction data come from?

All transaction data is fetched in real‑time from the Whale Alert API (docs.whale‑alert.io). No local storage of transactions is described.