tornado-cash-mcp

Tornado Cash MCP

An MCP server that tracks Tornado Cash deposits and withdrawals to reveal hidden asset trails and wallet interactions.

Features

• Query Latest Deposits: Retrieve the most recent deposit events with details including sender address (from), amount, block number, timestamp, and commitment.
• Query Latest Withdrawals: Fetch the latest withdrawal events with details including recipient address (to), amount, block number, and timestamp.

Prerequisites

• Python 3.10+
• uv (recommended package manager)
• A valid The Graph API key for accessing the Tornado Cash Subgraph

Installation

1. Clone the repository:
   git clone https://github.com/kukapay/tornado-cash-mcp.git cd tornado-cash-mcp
2. install dependencies using uv:
   uv sync
3. Installing to Claude Desktop: Install the server as a Claude Desktop application:
   uv run mcp install main.py --name "tornado-cash-mcp"
   Configuration file as a reference:
   { "mcpServers": { "Tornado Cash": { "command": "uv", "args": [ "--directory", "/path/to/tornado-cash-mcp", "run", "main.py" ], "env": { "THEGRAPH_API_KEY": "the_graph_api_key"} } } }
   Replace /path/to/tornado-cash-mcp with your actual installation path, and the_graph_api_key with your API key from The Graph.

Tools

Use the MCP Inspector UI or integrate with a compatible client (e.g., Claude Desktop) to call the tools.

Query Latest Deposits

Example prompt:

Example output:

Query Latest Withdrawals

Example prompt:

Example output:

License

This project is licensed under the MIT License. See LICENSE for details.