whale-tracker-mcp

WHAT IT CONNECTS

What whale-tracker-mcp gives an AI Agent

• **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.
• **Python**: Version 3.10 or higher.
• **Whale Alert API Key**: Sign up at [whale-alert.io](https://whale-alert.io/) to obtain an API key.
• **MCP Client**: Compatible with MCP clients like Claude Desktop or the MCP Inspector.
• **Clone the repository**:
• Install dependencies: We recommend using uv for dependency management:
• Set up your API key: Create a .env file in the project root and add your Whale Alert API key:
• `--name "WhaleTracker"`: Sets a custom name for the server in Claude Desktop.
• `-f .env`: Loads the API key from the .env file.
• "Show me recent whale transactions on Bitcoin."
• "Get details for transaction ID 123456789."
• "Analyze whale activity on Ethereum."
• Create a .env file:
• Ensure `python-dotenv` is installed (included in the dependencies).
• The server will automatically load the key at startup.
• 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.