Whale Tracker MCP Server

A mcp server for tracking cryptocurrency whale transactions.

Local serverstdioPython

What is the Whale Tracker MCP server?

Connect Whale Tracker to Claude, Cursor or any other MCP client and it stops being a tab you switch to. A mcp server for tracking cryptocurrency whale transactions. The whale tracker mcp server is what makes that connection.

What the server does

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

  • 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
  • whale://transactions/{blockchain}: Expose recent transactions for a specified blockchain as contextual data
  • 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

Installation

Installation goes through your MCP client rather than a global install: point it at @smithery/cli on npm and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.

Credentials and setup notes

Configuration is passed through the environment: WHALE_ALERT_API_KEY. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

  • 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.

Where it fits

This sits in the developer tooling group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. It is maintained by kukapay; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Whale Tracker's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Worth knowing first

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

How to install the Whale Tracker MCP server

{
  "mcpServers": {
    "whale-tracker": {
      "command": "npx",
      "args": ["-y", "@smithery/cli"],
      "env": {
        "WHALE_ALERT_API_KEY": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

  • 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.
VariableDescriptionRequired
WHALE_ALERT_API_KEYCredential the server authenticates with.Yes

Frequently asked questions

Python 3.10 or higher, a Whale Alert API key (sign up at whale‑alert.io), and an MCP‑compatible client such as Claude Desktop or the MCP Inspector.