# whale-tracker-mcp

> MCP Server

The whale-tracker-mcp server tracks cryptocurrency whale transactions using the Whale Alert API, exposing tools, resources, and prompts to MCP-compatible clients like Claude Desktop for real-time analysis. The whale-tracker-mcp server tracks

## Overview

- **Category:** Developer Tools
- **Language:** Python
- **Stars:** 59
- **Forks:** 2
- **Owner:** kukapay
- **GitHub:** https://github.com/kukapay/whale-tracker-mcp
- **Created:** 2025-03-13T16:19:15+00:00
- **Updated:** 2025-03-28T07:18:02+00:00
- **Source:** https://model-context-protocol.com/servers/cryptocurrency-whale-transaction-tracker-server

## Setup

## Setup

1. **Clone the repository**:
```bash
git clone https://github.com/kukapay/whale-tracker-mcp.git
cd whale-tracker-mcp
```
2. 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
```
3. 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
```

## Tools

## Available Tools

1. `get_recent_transactions` (Fetch recent whale transactions with optional filters for blockchain, minimum value, and limit.)
2. `get_transaction_details` (Retrieve detailed information about a specific transaction by its ID.)
3. `whale://transactions/{blockchain}` (Expose recent transactions for a specified blockchain as contextual data.)
4. `query_whale_activity` (A reusable template for analyzing whale transaction patterns, optionally filtered by blockchain.)
5. Asynchronous API Calls (Uses `httpx` for efficient, non-blocking requests to the Whale Alert API.)
6. Environment Variable Support (Securely manage your API key via a `.env` file.)