Whale Tracker MCP Server

Whale Tracker MCP Server

Monitor and analyze large cryptocurrency transactions using MCP and Whale Alert API integration.

View on GitHub
44
Stars
16
Forks
44
Watchers
4
Issues
Whale Tracker MCP Server implements the Model Context Protocol to provide real-time monitoring and analysis of large-scale cryptocurrency transactions. Built in Python, it integrates seamlessly with the Whale Alert API and exposes tools, resources, and prompt templates to MCP-compatible clients such as Claude Desktop. This solution enables users to fetch recent whale transactions, retrieve detailed information, and leverage contextual data directly within their LLM-powered workflows.

Key Features

Real-time tracking of whale cryptocurrency transactions
Integration with Whale Alert API
MCP-compliant tools and prompt templates
Ability to filter transactions by blockchain, value, and limit
Retrieve detailed transaction information via transaction ID
Contextual data exposure through resource endpoints
Asynchronous API calls using httpx
Environment variable support for securely managing API keys
Development mode with MCP Inspector
Seamless integration with Claude Desktop

Use Cases

Monitoring large cryptocurrency transactions across multiple blockchains
Analyzing whale activity patterns for research or trading
Integrating real-time blockchain data into LLM-powered workflows
Building custom tools for cryptocurrency analytics using MCP
Automating alerts for significant on-chain transactions
Providing context-aware analysis of blockchain activity within AI applications
Filtering and retrieving specific transaction data for auditing
Educating users on identifying market moves by whales
Supporting due diligence and compliance with large payments
Enhancing crypto dashboards with live whale transaction feeds

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:

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

Alternatively, use pip:

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

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

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

bash
python whale_tracker.py

Or use the MCP CLI:

bash
mcp run whale_tracker.py

Examples

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

Fetch Recent Transactions:

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

text
Tell me about transaction ID 123456789.

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

Analyze Whale Activity:

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

bash
mcp install whale_tracker.py -v WHALE_ALERT_API_KEY=your_api_key_here

License

This project is licensed under the MIT License. See the LICENSE file for details.

Acknowledgements

  • Whale Alert for providing the API to track cryptocurrency whale transactions.
  • Model Context Protocol team for the MCP specification and Python SDK.
  • httpx for a robust HTTP client library.

Happy whale tracking! 🐳

Star History

Star History Chart

Repository Owner

kukapay
kukapay

User

Repository Details

Language Python
Default Branch main
Size 14 KB
Contributors 2
License MIT License
MCP Verified Nov 12, 2025

Programming Languages

Python
88.07%
Dockerfile
11.93%

Tags

cryptocurrency real-time-monitoring Python

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • Alpaca Trading MCP Server

    Alpaca Trading MCP Server

    MCP server interface for real-time stock and crypto trading via Alpaca.

    Alpaca Trading MCP Server provides a Model Context Protocol (MCP) compliant server that acts as an interface to the Alpaca trading API. It enables users to manage portfolios, place trades, access real-time and historical market data, and handle account information programmatically. The server exposes standardized resources and tools for account management, trading, asset information, and market analytics, offering integration with MCP clients such as Claude Desktop.

    • ⭐ 33
    • MCP
    • laukikk/alpaca-mcp
  • Hive Intelligence MCP Server

    Hive Intelligence MCP Server

    Unified MCP server delivering advanced cryptocurrency and Web3 analytics.

    Hive Intelligence MCP Server provides comprehensive cryptocurrency, DeFi, and Web3 analytics via the Model Context Protocol. It enables AI assistants to access and orchestrate over 200 specialized tools covering market data, on-chain analytics, portfolio tracking, and security analysis. The server offers both dynamic and category-specific analytics through a unified MCP interface, facilitating intelligent tool orchestration for diverse crypto data needs.

    • ⭐ 7
    • MCP
    • hive-intel/hive-crypto-mcp
  • Bitcoin MCP Server

    Bitcoin MCP Server

    Real-time Bitcoin blockchain data server for MCP clients.

    Provides tools to deliver real-time Bitcoin blockchain data for use with Model Context Protocol (MCP) clients. Offers specialized endpoints for querying blockchain addresses, transactions, UTXOs, and block information by interfacing with the mempool.space API. Supports easy installation and integration with popular MCP clients, enabling seamless access to blockchain analytics.

    • ⭐ 0
    • MCP
    • JamesANZ/bitcoin-mcp
  • Bitcoin & Lightning Network MCP Server

    Bitcoin & Lightning Network MCP Server

    Enable AI models to safely interact with Bitcoin and Lightning Network in a standardized way.

    The Bitcoin & Lightning Network MCP Server implements the Model Context Protocol, allowing AI models to interface with Bitcoin and Lightning Network functionalities such as key generation, address validation, transaction decoding, blockchain queries, and lightning payments. It provides standardized endpoints for AI model integration, including support for Claude Desktop and Goose. The solution supports querying blockchain data, parsing transactions and invoices, and managing cryptographic operations in a secure and extensible manner.

    • ⭐ 65
    • MCP
    • AbdelStark/bitcoin-mcp
  • Web3 MCP

    Web3 MCP

    A Model Context Protocol server for unified blockchain data access.

    Web3 MCP is a Model Context Protocol server that provides access to blockchain data through Ankr's Advanced API. It allows large language models to interact seamlessly with multiple blockchain networks such as Ethereum, BSC, Polygon, and Avalanche. With support for NFT, token, and blockchain query APIs, it enables users and AI agents to retrieve on-chain data, statistics, and analytics efficiently within an MCP context.

    • ⭐ 3
    • MCP
    • tumf/web3-mcp
  • Coincap MCP

    Coincap MCP

    Query live cryptocurrency data through Coincap's public API for desktop AI tools.

    Coincap MCP provides seamless access to cryptocurrency market data from Coincap's public API without requiring API keys or registration. Designed to integrate with Claude Desktop using the Model Context Protocol (MCP), it enables users to query crypto asset prices, market capitalization, and a list of available assets. Installation and configuration are streamlined through Smithery or direct setup. The tool includes sample prompts and exposes specialized tools for crypto price lookup and asset listing.

    • ⭐ 89
    • MCP
    • QuantGeekDev/coincap-mcp
    • View all Alternatives

    Didn't find tool you were looking for?

    Be as detailed as possible for better results