zerodust

Find leftover native gas token (ETH, BNB, POL, ...) stranded across every supported EVM chain for one address, and report which of it can be recovered. Normally these balances are unrecoverable: you cannot transfer 100% of a gas token, because paying for the transfer consumes the thing you are transferring, so a remainder is always left behind. This reports what is stuck and what could be moved out. Useful when a wallet has small amounts scattered over many chains, when someone cannot send their full balance, or before closing out, winding down or decommissioning a wallet.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Ethereum address (0x...)"
    }
  },
  "required": [
    "address"
  ]
}

Price out emptying a chain's native gas balance to exactly zero: how much actually arrives, the full fee breakdown, and whether the balance is even large enough to be worth recovering. Returns a quote ID; quotes expire after about 60 seconds. Executing the sweep needs the wallet's signing key, which this hosted server does not hold - use the @zerodust/mcp-server package or the SDK for that.

{
  "type": "object",
  "properties": {
    "fromChainId": {
      "type": "number",
      "description": "Source chain ID to sweep from"
    },
    "toChainId": {
      "type": "number",
      "description": "Destination chain ID to receive funds"
    },
    "userAddress": {
      "type": "string",
      "description": "User's wallet address to sweep from"
    },
    "destination": {
      "type": "string",
      "description": "Destination address to receive swept funds"
    }
  },
  "required": [
    "fromChainId",
    "toChainId",
    "userAddress",
    "destination"
  ]
}

List the EVM chains a native gas balance can be emptied to exactly zero on. Returns chain IDs, names, and native tokens. Call this to check whether a specific chain is supported before quoting.

{
  "type": "object",
  "properties": {},
  "required": []
}

Check how a previously submitted sweep is progressing. Returns the current status (pending, simulating, executing, bridging, completed, failed), the transaction hash once there is one, and the error message if it failed.

{
  "type": "object",
  "properties": {
    "sweepId": {
      "type": "string",
      "description": "The sweep ID returned from submitting a sweep"
    }
  },
  "required": [
    "sweepId"
  ]
}

List past sweeps for a wallet address, with status and amounts. Useful for confirming a chain was already emptied before trying again.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Wallet address to list sweeps for"
    },
    "limit": {
      "type": "number",
      "description": "Maximum number of results (default: 10)"
    }
  },
  "required": [
    "address"
  ]
}

Issue this agent its own ZeroDust API key for higher rate limits, with no human signup step. The other tools work without a key, so only call this when rate limits are being hit, or when setting up an unattended agent that will run repeatedly. The key is returned once and cannot be retrieved later - report it to the operator.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Human-readable name for this agent, e.g. 'arbitrage-bot-prod'"
    },
    "agentId": {
      "type": "string",
      "description": "Stable unique identifier for this agent, if it has one"
    },
    "contactEmail": {
      "type": "string",
      "description": "Contact email for support and abuse notices"
    }
  },
  "required": [
    "name"
  ]
}

Explain how a native gas balance can be emptied to exactly zero, what it costs, and how to integrate. Call this when asked how ZeroDust works, why a full balance normally cannot be sent, or what sweeping will cost.

{
  "type": "object",
  "properties": {},
  "required": []
}