Spark
Sign In
MCP Connector

Track Whale Transactions and Analyze Crypto Activity

MCP server tracking large cryptocurrency whale transactions via the Whale Alert API, with tools, resources, and prompts for Claude Desktop.

Connect
Works with whale alert apihttpxpython dotenv
kukapay
Maintainer?
91
Spark score
out of 100
Updated May 2025
Fresher alternatives ↓
Version 1.0.0
Models
claudeuniversal
Add to Favorites

Why it matters

Monitor and analyze large cryptocurrency transactions in real-time using the Whale Alert API. This asset provides tools to retrieve transaction details and query whale activity patterns.

Outcomes

What it gets done

01

Retrieve the latest whale transactions with optional filters.

02

Get detailed information about specific transactions by ID.

03

Analyze whale transaction patterns using predefined prompts.

04

Monitor large cryptocurrency movements across different blockchains.

Install

Add it to your toolbox

Run in your project directory:

curl -fsSL https://spark.entire.vc/get/vb-whale-tracker-mcp | bash

Capabilities

Tools your agent gets

get_recent_transactions

Retrieves the latest whale transactions with optional filters by blockchain, minimum amount, and limit

get_transaction_details

Retrieves detailed information about a specific transaction by its ID

Overview

whale-tracker-mcp MCP Server

An MCP server integrating the Whale Alert API to track large cryptocurrency transactions in real time, exposing tools to fetch recent transactions and transaction details, a resource for per-blockchain transaction data, and a prompt for whale-activity analysis. Use when an AI assistant needs to surface or analyze large crypto transactions on demand. Requires a Whale Alert API key and is scoped to whatever data that API tracks, not a general blockchain explorer.

What it does

A Python-based MCP server that integrates with the Whale Alert API to enable real-time tracking and analysis of large cryptocurrency transactions ("whale" movements) directly inside MCP-compatible clients like Claude Desktop. It's built for cryptocurrency enthusiasts, developers, and analysts who want whale activity monitoring inside their LLM-powered workflows rather than a separate dashboard.

It exposes two tools: get_recent_transactions, which fetches recent whale transactions with optional filters for blockchain, minimum value, and result limit, and get_transaction_details, which retrieves full information about a specific transaction by ID. It also exposes a resource, whale://transactions/{blockchain}, that surfaces recent transactions for a given blockchain as contextual data the model can reference, and a reusable prompt template, query_whale_activity, for analyzing whale transaction patterns, optionally filtered by blockchain. API calls to Whale Alert run asynchronously via httpx for non-blocking requests, and the API key is managed securely through a .env file rather than being hardcoded.

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

Once installed, example interactions include asking for recent Ethereum whale transactions above a $1,000,000 minimum value (which triggers get_recent_transactions with blockchain="ethereum" and min_value=1000000), requesting details for a specific transaction ID (which triggers get_transaction_details), or asking for an analysis of recent Bitcoin whale activity (which triggers the query_whale_activity prompt against the whale://transactions/bitcoin resource).

When to use - and when NOT to

Use this connector when you want an AI assistant to surface and analyze large cryptocurrency transactions in real time, whether checking recent whale movements on a specific blockchain, looking up a specific transaction's details, or asking for a pattern analysis of recent whale activity. It requires a Whale Alert API key (obtained by signing up at whale-alert.io), so it cannot be used without that external subscription, and its scope is limited to whatever transaction data the Whale Alert API tracks - it is not a general blockchain explorer or wallet-balance tool.

Capabilities

Accepts a natural-language request specifying a blockchain, a minimum transaction value, a transaction ID, or an analysis request. Returns whale transaction data (amount, blockchain, and transaction details) from the Whale Alert API, or an analysis generated from the query_whale_activity prompt template, built on the Whale Alert API for transaction data, the MCP Python SDK for the server protocol, httpx for asynchronous HTTP calls, and python-dotenv for loading the API key from a .env file.

How to install

Install via Smithery's CLI for automatic Claude Desktop setup, or manually via uv add "mcp[cli]" httpx python-dotenv (or pip install mcp httpx python-dotenv) followed by mcp install whale_tracker.py --name "WhaleTracker" -f .env. It can also run standalone via python whale_tracker.py or mcp run whale_tracker.py, and be tested locally with the MCP Inspector via mcp dev whale_tracker.py --with-editable ..

Who it's for

Cryptocurrency analysts, developers, and enthusiasts who want to monitor and analyze large ('whale') transaction activity across blockchains conversationally inside Claude Desktop or another MCP client, instead of manually checking a separate whale-tracking dashboard.

Source README

Whale Tracker MCP Server

A Model Context Protocol (MCP) server for tracking cryptocurrency whale transactions using the Whale Alert API

mit license
python versions
smithery badge

Table of Contents

Overview

The whale-tracker-mcp server is a Python-based implementation of the Model Context Protocol (MCP) that integrates with the Whale Alert API. It enables real-time tracking and analysis of large cryptocurrency transactions ("whale" movements) by exposing tools, resources, and prompts to MCP-compatible clients like Claude Desktop.

This server is designed for cryptocurrency enthusiasts, developers, and analysts who want to monitor whale activity directly within their LLM-powered workflows.

Features

  • 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.
  • Resources:
    • whale://transactions/{blockchain}: Expose recent transactions for a specified blockchain as contextual data.
  • Prompts:
    • query_whale_activity: A reusable template for analyzing whale transaction patterns, optionally filtered by blockchain.
  • Asynchronous API Calls: Uses httpx for efficient, non-blocking requests to the Whale Alert API.
  • Environment Variable Support: Securely manage your API key via a .env file.

Prerequisites

  • Python: Version 3.10 or higher.
  • Whale Alert API Key: Sign up at whale-alert.io to obtain an API key.
  • MCP Client: Compatible with MCP clients like Claude Desktop or the MCP Inspector.

Installation

Installing via Smithery

To install Whale Tracker for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @kukapay/whale-tracker-mcp --client claude
  1. Clone the repository:
git clone https://github.com/kukapay/whale-tracker-mcp.git
cd whale-tracker-mcp
  1. Install dependencies: We recommend using uv for dependency management:
uv add "mcp[cli]" httpx python-dotenv

Alternatively, use pip:

pip install mcp httpx python-dotenv
  1. Set up your API key: Create a .env file in the project root and add your Whale Alert API key:
WHALE_ALERT_API_KEY=your_api_key_here

Usage

Running in Development Mode

Test the server locally with the MCP Inspector:

mcp dev whale_tracker.py --with-editable .

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

Integrating with Claude Desktop

Install the server into Claude Desktop for seamless integration:

mcp install whale_tracker.py --name "WhaleTracker" -f .env
  • --name "WhaleTracker": Sets a custom name for the server in Claude Desktop.
  • -f .env: Loads the API key from the .env file.

Restart Claude Desktop after installation. Look for the hammer icon in the input box to confirm the server is loaded, then try commands like:

  • "Show me recent whale transactions on Bitcoin."
  • "Get details for transaction ID 123456789."
  • "Analyze whale activity on Ethereum."

Direct Execution

Run the server standalone for custom deployments:

python whale_tracker.py

Or use the MCP CLI:

mcp run whale_tracker.py

Examples

Here’s how you might interact with the server in Claude Desktop:

Fetch Recent Transactions:

What are the latest whale transactions on Ethereum with a minimum value of $1,000,000?

The server calls get_recent_transactions with blockchain="ethereum" and min_value=1000000.

Get Transaction Details:

Tell me about transaction ID 123456789.

The server uses get_transaction_details to fetch and display the transaction data.

Analyze Whale Activity:

Analyze recent whale transactions on Bitcoin.

The query_whale_activity prompt triggers an analysis based on the whale://transactions/bitcoin resource.

API Key Configuration

The server requires a Whale Alert API key, which is loaded from the WHALE_ALERT_API_KEY environment variable. To configure it:

  • Create a .env file:
WHALE_ALERT_API_KEY=your_api_key_here
  • Ensure python-dotenv is installed (included in the dependencies).
  • The server will automatically load the key at startup.

Alternatively, pass the key directly when running the server:

mcp install whale_tracker.py -v WHALE_ALERT_API_KEY=your_api_key_here

FAQ

Common questions

Discussion

Questions & comments · 0

Sign In Sign in to leave a comment.