What is Tornado Cash Mcp

Tornado Cash MCP is a server application that tracks and analyzes deposits and withdrawals from Tornado Cash, providing insights into asset trails and wallet interactions within the Ethereum blockchain ecosystem.

Use cases

This tool enables users to monitor recent deposit and withdrawal activities for Tornado Cash, making it useful for blockchain analytics, auditing purposes, and monitoring transactions for compliance or security reasons.

How to use

Users can install the Tornado Cash MCP by cloning the repository, installing required dependencies via the recommended package manager, and configuring it with an API key from The Graph. Then, the server can be run to fetch and display the latest transaction data through user queries.

Key features

The main features include querying the latest deposits with details about sender addresses, amounts, timestamps, and commitment information, as well as fetching the latest withdrawals, providing recipient addresses, amounts, and block numbers.

Where to use

Tornado Cash MCP can be utilized in blockchain analysis platforms, compliance tools, and personal asset tracking applications. It can also be integrated into desktop applications like Claude Desktop for enhanced usability.

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:

"Show me the latest 3 deposits from Tornado Cash."

Example output:

+------------+---------------+--------------+---------------------+--------------+
| from       | amount        | blockNumber  | time                | commitment   |
+============+===============+==============+=====================+==============+
| 0xdef...   |           0.1 | 12345678     | 2023-10-12 15:30:00 | 0xabc...     |
| 0xdee...   |             1 | 12345677     | 2023-10-12 15:28:20 | 0xabd...     |
| 0xdef...   |            10 | 12345676     | 2023-10-12 15:26:40 | 0xabe...     |
+------------+---------------+--------------+---------------------+--------------+

Query Latest Withdrawals

Example prompt:

"Get the most recent 2 withdrawals from Tornado Cash."

Example output:

+------------+---------------+--------------+---------------------+
| to         | amount        | blockNumber  | time                |
+============+===============+==============+=====================+
| 0x789...   |             1 | 12345679     | 2023-10-13 14:40:00 |
| 0x78a...   |           100 | 12345678     | 2023-10-13 14:38:20 |
+------------+---------------+--------------+---------------------+

License

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