Log inSubmit server
Zerodust logo

Zerodust

by andresdefi

Inspect stranded EVM gas and optionally sweep balances to zero across supported chains.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Zerodust

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "andresdefi-zerodust": {
      "command": "npx",
      "args": [
        "-y",
        "@zerodust/mcp-server"
      ],
      "env": {
        "ZERODUST_API_KEY": "YOUR_VALUE_HERE",
        "ZERODUST_ALLOW_EXECUTE": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 11 tools correctly ().

Overview

andresdefi/zerodust MCP server connects agents to ZeroDust for inspecting and sweeping native gas balances across supported EVM chains. Read-only tools list chains, find recoverable balances, calculate quotes, and track sweep history or status; execution tools can empty one chain or consolidate multiple chains. Sweeps use sponsored execution, direct transactions, or bridging routes depending on the source chain, and support same-chain or cross-chain destinations. The local MCP package is paused and deprecated on npm, but can still use the public API with an operator-provided key.

Use cases

  • Inspect stranded gas across every supported EVM chain
  • Quote the recovery of a wallet's leftover native balances
  • Simulate a single-chain sweep before moving funds
  • Consolidate scattered gas balances onto one destination chain
  • Track whether a wallet has already been emptied

Key features

  • Cross-chain native gas balance discovery
  • Exact-zero single-chain sweeps
  • Multi-chain balance consolidation
  • Fee quotes with short expiration
  • Dry-run execution and sweep tracking
  • Destination-allowlisted execution

Tools11

What Zerodust lets your agent do. Expand a tool for its parameters.

Verified live~2.0k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked

Recent health check succeeded.

24/24 checks healthy over the last 95d

What it can do

From the 11 tools this server returned when we ran it; 11 declare their own safety hints.

Can delete or modify data · 2Handles credentials · 4Makes network requests · 9Read-only tools · 9
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceNot published
Package age273 days
Maintainers1

Observed 2026-11-12 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 3d ago via OSV.dev · @zerodust/mcp-server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars2Stargazers on the source repository.
npm downloads421Package downloads in the last 30 days.
Last commit7d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed11Callable tools this server registers over MCP.
Directory activity8 viewsConfig copies, upvotes, and views on AllMCPs.

How Zerodust works

What andresdefi/zerodust MCP server does

ZeroDust addresses a limitation of ordinary native-token transfers: sending a wallet's entire gas balance normally requires retaining some of that same token to pay transaction fees. The MCP server exposes agent tools for identifying these stranded amounts and, when execution is enabled, moving the full balance so the source chain ends at exactly zero.

It works with native gas assets across supported EVM networks, including ETH, BNB, POL, and other chain-specific tokens. A sweep may deliver funds to an address on the same chain or use a bridge to reach another EVM chain. The balance and destination are bounded by the sweep request, while the fee limit is signed as part of the intent.

How it works

For chains using EIP-7702, the wallet authorizes a temporary delegation and a ZeroDust sponsor submits the transaction. The sponsor pays the gas and is reimbursed from the amount being swept. Other supported networks use direct wallet transactions planned to the exact wei, with chain-specific protections or paymaster support where needed. Cross-chain delivery can use Relay, Across, Stargate, Gas.zip, or a chain's own bridge, depending on the route.

The normal workflow is read-only first: check supported chains, inspect balances, request a quote, and confirm the wallet and permitted destinations. A quote includes the expected amount received, fee details, and whether recovery is worthwhile; it expires after about 60 seconds. Execution can then be simulated with dryRun=true before submitting a real sweep.

Setup and configuration

Run the local package with npx @zerodust/mcp-server. The MCP package and hosted agent services are paused and deprecated on npm, while the local server and SDK can still call the public ZeroDust API. Read-only operations work without an API key. ZERODUST_API_KEY can be supplied for higher rate limits; a key issued by the registration tool is returned once and should be reported to the operator for configuration.

Real execution requires ZERODUST_ALLOW_EXECUTE=true and a signing key. Without both, the address and sweep tools return an error and do not move funds. Keep execution disabled for agents that only need balance inspection, quoting, or history.

Tools and capabilities

  • zerodust_get_chains checks chain IDs, names, and native tokens supported for exact-zero recovery.
  • zerodust_get_balances scans an address across supported chains and distinguishes stranded amounts from recoverable balances.
  • zerodust_get_quote calculates expected delivery, fees, and a short-lived quote ID.
  • zerodust_get_agent_address reports the signing wallet and allowed destinations, with a dry-run option.
  • zerodust_sweep empties one chain; zerodust_sweep_all consolidates balances from multiple chains onto one destination chain.
  • zerodust_get_sweep_status and zerodust_list_sweeps provide progress and historical records.
  • zerodust_info explains the mechanism and costs, while zerodust_register_api_key issues an API key when rate limits require it.

Limitations and notes

Fees include 1% of swept value, subject to a minimum and maximum, plus transaction gas, possible rollup data fees, and cross-chain bridge charges. Balances below $1 use a different percentage fee. Some routes deliver a token rather than native gas when no native-gas bridge is available, and the quote identifies that outcome.

Execution moves real funds. The destination must be confirmed before sweeping, and the quote should be shown first. ZeroDust reports internal security review and testing, but its contracts are not externally audited. The package is intended for local use rather than the disabled hosted MCP endpoint or agent key-signup service.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Zerodust

andresdefi/zerodust is an MCP server that connects AI agents to the ZeroDust API and supported EVM chains. Its main tools inspect stranded native gas, return recovery quotes, track sweeps, and optionally empty one or many chain balances to exactly zero through same-chain or cross-chain execution.

Install or run it locally with `npx @zerodust/mcp-server`. The npm agent package is paused and deprecated, but the local MCP server can still use the public ZeroDust API; read-only tools work without an API key.

Enable `ZERODUST_ALLOW_EXECUTE=true` and provide a signing key. The server refuses to move funds unless both are configured. Confirm the agent address and allowed destinations, request a quote, and use `dryRun=true` to rehearse the operation before submitting it.

No, read-only tools work without an API key. Set `ZERODUST_API_KEY` when higher rate limits are needed or when configuring an unattended agent; the registration tool returns a key once, and the operator must store it.

Related MCP servers

All in Finance & Fintech All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewZerodust AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/andresdefi-zerodust?style=directory)](https://allmcps.com/mcp/andresdefi-zerodust)
HTML Embed
<a href="https://allmcps.com/mcp/andresdefi-zerodust"><img src="https://allmcps.com/api/badge/andresdefi-zerodust?style=directory" alt="Zerodust on AllMCPs" /></a>