Whale Tracker MCP Server
A Model Context Protocol (MCP) server for tracking cryptocurrency whale transactions using the Whale Alert API
Table of Contents
- Overview
- Features
- Prerequisites
- Installation
- Usage
- Running in Development Mode
- Integrating with Claude Desktop
- Direct Execution
- Examples
- API Key Configuration
- License
- Acknowledgements
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
httpxfor efficient, non-blocking requests to the Whale Alert API. - Environment Variable Support: Securely manage your API key via a
.envfile.
