A Model Context Protocol (MCP) server for tracking large cryptocurrency (“whale”) transactions via the Whale Alert API.
https://github.com/kukapay/whale-tracker-mcpStop switching between whale tracking websites and your development environment. The Whale Tracker MCP server brings real-time cryptocurrency whale transaction monitoring directly into Claude Desktop and other MCP-compatible tools, giving you instant access to market-moving transactions without breaking your flow.
Manual whale tracking is productivity poison. You're either constantly alt-tabbing to whale alert sites, writing custom API integrations for every project, or missing crucial market signals entirely. This MCP server solves that by making whale data a first-class citizen in your LLM conversations.
Instead of "let me check whale-alert.io real quick," you can ask Claude: "Show me recent whale transactions on Ethereum over $1M" and get structured data immediately. Your analysis workflows become conversational, your research stays in-context, and you catch market movements faster.
Real-Time Transaction Monitoring: Query recent whale movements across multiple blockchains with filters for minimum transaction value, specific networks, and transaction limits. No rate limiting headaches or API key juggling.
Deep Transaction Analysis: Pull detailed transaction data by ID, including sender/receiver addresses, token information, USD values, and timestamps. Perfect for forensic analysis or pattern recognition work.
Contextual Data Resources: The server exposes blockchain-specific transaction feeds as MCP resources, so your LLM can reference recent whale activity while analyzing market trends or answering research questions.
Pre-Built Analysis Prompts: Skip writing the same whale analysis prompts repeatedly. The included templates handle common analysis patterns, from identifying unusual activity to correlating transactions across networks.
DeFi Protocol Monitoring: Track large movements affecting your protocol's liquidity pools. Set up automated monitoring for whale transactions that might impact your token's price or liquidity depth.
Market Research Workflows: Analyze whale behavior patterns before major market moves. Query transactions by network and value thresholds to identify accumulation or distribution phases.
Trading Signal Development: Incorporate whale movement data into your trading algorithms. The structured data format makes it easy to feed transaction patterns into your analysis pipelines.
Portfolio Risk Assessment: Monitor large holder movements for tokens in your portfolio. Get alerts when whales move significant amounts that might affect your positions.
The server runs as a standard MCP implementation with straightforward setup:
# Install via Smithery (recommended)
npx -y @smithery/cli install @kukapay/whale-tracker-mcp --client claude
# Or clone and configure manually
git clone https://github.com/kukapay/whale-tracker-mcp.git
cd whale-tracker-mcp
pip install mcp httpx python-dotenv
Add your Whale Alert API key to a .env file, restart Claude Desktop, and you're tracking whales in natural language immediately.
This isn't just another API wrapper. The MCP architecture means whale data becomes part of your LLM's working memory. Ask follow-up questions, cross-reference transactions with market data, or build complex analysis chains without losing context.
The async implementation handles multiple concurrent requests efficiently, so you can query multiple networks or time ranges simultaneously without blocking your workflow.
Your whale tracking moves from reactive browsing to proactive analysis embedded directly in your development process. Stop chasing whale alerts manually and start building them into your decision-making workflows.