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.

📦 Installation

Prerequisites

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

Steps

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.

💻 Usage Examples

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

Basic Usage

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.