Tornado Cash

An MCP server that tracks Tornado Cash deposits and withdrawals.

python

3

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "kukapay-tornado-cash-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/tornado-cash-mcp",
        "run",
        "main.py"
      ],
      "env": {
        "THEGRAPH_API_KEY": "the_graph_api_key"
      }
    }
  }
}

You can run a self-contained MCP server that tracks Tornado Cash deposits and withdrawals by querying The Graph Subgraph. It exposes two core actions you can perform: fetch the latest deposits with sender, amount, block, time, and commitment, and fetch the latest withdrawals with recipient, amount, block, and time. This enables you to discover asset trails and wallet interactions in a streamlined, programmable way.

How to use

You interact with the Tornado Cash MCP server through an MCP client. Use the client to call the available tools for deposits and withdrawals. Practical usage includes asking for the most recent deposits or withdrawals and reviewing the key fields such as sender or recipient, amount, block, time, and commitment where applicable.

How to install

Prerequisites you need before installing the server.

Install Python 3.10 or newer and pick a package manager you prefer for local development. The Graph API key is required to access the Tornado Cash Subgraph.

# 1) Clone the project
git clone https://github.com/kukapay/tornado-cash-mcp.git
cd tornado-cash-mcp

# 2) Install dependencies using uv
uv sync

# 3) Install to Claude Desktop (or your MCP environment)
uv run mcp install main.py --name "tornado-cash-mcp"

Configuration and startup details

{
  "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.

## Advanced startup notes

The startup command shown above uses uv to run the Tornado Cash MCP server from its installation directory. Ensure your environment variables are set so the server can authenticate with The Graph Subgraph endpoints. If you run into access issues, verify the API key is correctly configured in the env block.

## Available tools

### Query Latest Deposits

Fetch the most recent deposit events with details including sender address, amount, block number, timestamp, and commitment.

### Query Latest Withdrawals

Fetch the latest withdrawal events with details including recipient address, amount, block number, and timestamp.