io.github.andresdefi/zerodust MCP Server

Name: io.github.andresdefi/zerodust MCP Server
Author: io.github.andresdefi

io.github.andresdefi/zerodust

Repository Registry

What is the io.github.andresdefi/zerodust MCP server?

Recover stranded native gas: empty a chain's balance to exactly zero on 25 EVM chains.

How to install io.github.andresdefi/zerodust

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

ZERODUST_API_URL
Custom API URL (defaults to https://api.zerodust.xyz)
ZERODUST_API_KEY
secret
API key for higher rate limits. An agent can issue itself one with the zerodust_register_api_key tool, with no human signup step.
ZERODUST_ALLOW_EXECUTE
Set to "true" to enable the sweep tools. Sweeping moves real funds, so it is off by default and also requires one of the four signing-key variables below.
ZERODUST_SIGNER_MODULE
Path or specifier of a module whose default export returns a viem LocalAccount. This is how Turnkey, Privy, AWS KMS or any other custody service is used, without a raw key ever reaching this server. Preferred over ZERODUST_PRIVATE_KEY.
ZERODUST_KEYSTORE_FILE
Path to an encrypted V3 keystore (as produced by `cast wallet import` or geth). Requires ZERODUST_KEYSTORE_PASSWORD_FILE or ZERODUST_KEYSTORE_PASSWORD.
ZERODUST_KEYSTORE_PASSWORD_FILE
Path to a file containing the keystore password, so the password never enters the MCP config.
ZERODUST_KEYSTORE_PASSWORD
secret
Keystore password inline. Prefer ZERODUST_KEYSTORE_PASSWORD_FILE.
ZERODUST_PRIVATE_KEY_FILE
Path to a file containing a hex private key, so the key stays out of the MCP config.
ZERODUST_PRIVATE_KEY
secret
Private key for the agent's own wallet, inline. Used locally to sign the EIP-7702 authorization and EIP-712 sweep intent; never transmitted, only the resulting signatures are sent. The signer-module, keystore and key-file options above keep it out of your config entirely.
ZERODUST_ALLOWED_DESTINATIONS
Comma-separated allowlist of sweep destinations. When unset, funds can only be swept to the agent's own address.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "zerodust": {
      "command": "npx",
      "args": [
        "-y",
        "@zerodust/mcp-server"
      ],
      "env": {
        "ZERODUST_API_URL": "<YOUR_ZERODUST_API_URL>",
        "ZERODUST_API_KEY": "<YOUR_ZERODUST_API_KEY>",
        "ZERODUST_ALLOW_EXECUTE": "<YOUR_ZERODUST_ALLOW_EXECUTE>",
        "ZERODUST_SIGNER_MODULE": "<YOUR_ZERODUST_SIGNER_MODULE>",
        "ZERODUST_KEYSTORE_FILE": "<YOUR_ZERODUST_KEYSTORE_FILE>",
        "ZERODUST_KEYSTORE_PASSWORD_FILE": "<YOUR_ZERODUST_KEYSTORE_PASSWORD_FILE>",
        "ZERODUST_KEYSTORE_PASSWORD": "<YOUR_ZERODUST_KEYSTORE_PASSWORD>",
        "ZERODUST_PRIVATE_KEY_FILE": "<YOUR_ZERODUST_PRIVATE_KEY_FILE>",
        "ZERODUST_PRIVATE_KEY": "<YOUR_ZERODUST_PRIVATE_KEY>",
        "ZERODUST_ALLOWED_DESTINATIONS": "<YOUR_ZERODUST_ALLOWED_DESTINATIONS>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "zerodust": {
      "command": "npx",
      "args": [
        "-y",
        "@zerodust/mcp-server"
      ],
      "env": {
        "ZERODUST_API_URL": "<YOUR_ZERODUST_API_URL>",
        "ZERODUST_API_KEY": "<YOUR_ZERODUST_API_KEY>",
        "ZERODUST_ALLOW_EXECUTE": "<YOUR_ZERODUST_ALLOW_EXECUTE>",
        "ZERODUST_SIGNER_MODULE": "<YOUR_ZERODUST_SIGNER_MODULE>",
        "ZERODUST_KEYSTORE_FILE": "<YOUR_ZERODUST_KEYSTORE_FILE>",
        "ZERODUST_KEYSTORE_PASSWORD_FILE": "<YOUR_ZERODUST_KEYSTORE_PASSWORD_FILE>",
        "ZERODUST_KEYSTORE_PASSWORD": "<YOUR_ZERODUST_KEYSTORE_PASSWORD>",
        "ZERODUST_PRIVATE_KEY_FILE": "<YOUR_ZERODUST_PRIVATE_KEY_FILE>",
        "ZERODUST_PRIVATE_KEY": "<YOUR_ZERODUST_PRIVATE_KEY>",
        "ZERODUST_ALLOWED_DESTINATIONS": "<YOUR_ZERODUST_ALLOWED_DESTINATIONS>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "zerodust": {
      "command": "npx",
      "args": [
        "-y",
        "@zerodust/mcp-server"
      ],
      "env": {
        "ZERODUST_API_URL": "<YOUR_ZERODUST_API_URL>",
        "ZERODUST_API_KEY": "<YOUR_ZERODUST_API_KEY>",
        "ZERODUST_ALLOW_EXECUTE": "<YOUR_ZERODUST_ALLOW_EXECUTE>",
        "ZERODUST_SIGNER_MODULE": "<YOUR_ZERODUST_SIGNER_MODULE>",
        "ZERODUST_KEYSTORE_FILE": "<YOUR_ZERODUST_KEYSTORE_FILE>",
        "ZERODUST_KEYSTORE_PASSWORD_FILE": "<YOUR_ZERODUST_KEYSTORE_PASSWORD_FILE>",
        "ZERODUST_KEYSTORE_PASSWORD": "<YOUR_ZERODUST_KEYSTORE_PASSWORD>",
        "ZERODUST_PRIVATE_KEY_FILE": "<YOUR_ZERODUST_PRIVATE_KEY_FILE>",
        "ZERODUST_PRIVATE_KEY": "<YOUR_ZERODUST_PRIVATE_KEY>",
        "ZERODUST_ALLOWED_DESTINATIONS": "<YOUR_ZERODUST_ALLOWED_DESTINATIONS>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "zerodust": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@zerodust/mcp-server"
      ],
      "env": {
        "ZERODUST_API_URL": "<YOUR_ZERODUST_API_URL>",
        "ZERODUST_API_KEY": "<YOUR_ZERODUST_API_KEY>",
        "ZERODUST_ALLOW_EXECUTE": "<YOUR_ZERODUST_ALLOW_EXECUTE>",
        "ZERODUST_SIGNER_MODULE": "<YOUR_ZERODUST_SIGNER_MODULE>",
        "ZERODUST_KEYSTORE_FILE": "<YOUR_ZERODUST_KEYSTORE_FILE>",
        "ZERODUST_KEYSTORE_PASSWORD_FILE": "<YOUR_ZERODUST_KEYSTORE_PASSWORD_FILE>",
        "ZERODUST_KEYSTORE_PASSWORD": "<YOUR_ZERODUST_KEYSTORE_PASSWORD>",
        "ZERODUST_PRIVATE_KEY_FILE": "<YOUR_ZERODUST_PRIVATE_KEY_FILE>",
        "ZERODUST_PRIVATE_KEY": "<YOUR_ZERODUST_PRIVATE_KEY>",
        "ZERODUST_ALLOWED_DESTINATIONS": "<YOUR_ZERODUST_ALLOWED_DESTINATIONS>"
      }
    }
  }
}

Claude Code

claude mcp add zerodust --env ZERODUST_API_URL=<YOUR_ZERODUST_API_URL> --env ZERODUST_API_KEY=<YOUR_ZERODUST_API_KEY> --env ZERODUST_ALLOW_EXECUTE=<YOUR_ZERODUST_ALLOW_EXECUTE> --env ZERODUST_SIGNER_MODULE=<YOUR_ZERODUST_SIGNER_MODULE> --env ZERODUST_KEYSTORE_FILE=<YOUR_ZERODUST_KEYSTORE_FILE> --env ZERODUST_KEYSTORE_PASSWORD_FILE=<YOUR_ZERODUST_KEYSTORE_PASSWORD_FILE> --env ZERODUST_KEYSTORE_PASSWORD=<YOUR_ZERODUST_KEYSTORE_PASSWORD> --env ZERODUST_PRIVATE_KEY_FILE=<YOUR_ZERODUST_PRIVATE_KEY_FILE> --env ZERODUST_PRIVATE_KEY=<YOUR_ZERODUST_PRIVATE_KEY> --env ZERODUST_ALLOWED_DESTINATIONS=<YOUR_ZERODUST_ALLOWED_DESTINATIONS> -- npx -y @zerodust/mcp-server