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.

Related MCP server: crypto-trending-mcp

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.