Whale Tracker

A mcp server for tracking cryptocurrency whale transactions.

python

48

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "kukapay-whale-tracker-mcp": {
      "command": "mcp",
      "args": [
        "dev",
        "whale_tracker.py",
        "--with-editable",
        "."
      ],
      "env": {
        "WHALE_ALERT_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

You can use the Whale Tracker MCP Server to monitor large cryptocurrency transfers in real time by leveraging the Whale Alert API. This server exposes tools, data resources, and prompts for MCP-compatible clients to analyze whale activity within your workflows.

How to use

Interact with the Whale Tracker MCP Server through an MCP client to fetch recent whale transactions, inspect specific transactions, and run activity analyses across different blockchains. You can run in development mode to explore the available tools, resources, and prompts, or install the server into a client like Claude Desktop for seamless, integrated usage. Typical workflows include querying for recent transactions on a chosen blockchain, retrieving detailed data for a particular transaction ID, and analyzing whale activity patterns.

How to install

Prerequisites you need before installation include Python 3.10 or higher and a Whale Alert API key. You will also use the MCP client tools for development and deployment.

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

Clone the project, install dependencies, and prepare your API key.

git clone https://github.com/kukapay/whale-tracker-mcp.git
cd whale-tracker-mcp
uv add "mcp[cli]" httpx python-dotenv

Create a configuration file with your Whale Alert API key.

WHALE_ALERT_API_KEY=your_api_key_here

Development and execution commands

Use these commands to develop locally, install into a client, or run the server directly.

mcp dev whale_tracker.py --with-editable .

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

python whale_tracker.py

mcp run whale_tracker.py

API key configuration

Your Whale Alert API key must be available to the server at startup. Store the key in a .env file or pass it during setup.

# Example env file
WHALE_ALERT_API_KEY=your_api_key_here

Example usage

After installation, you can interact with the server using an MCP client to perform common tasks like fetching recent transactions, inspecting a transaction by ID, or analyzing activity by blockchain.

Notes

Ensure you restart your MCP client after installation so the Whale Tracker server is loaded. Look for the WhaleTracker integration in the client interface and verify the server is ready before issuing commands.

Available tools

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.

query_whale_activity

A reusable prompt template to analyze whale activity, optionally filtered by blockchain.

resources_whale_transactions

Expose recent whale transactions for a specified blockchain as contextual data under the whale://transactions/{blockchain} resource.