Command-line tool

The bouncebuster CLI wraps the same API, so you can verify addresses and clean files without leaving your terminal.

Install

npm install -g bouncebuster
# or run without installing:
npx bouncebuster --help

Authenticate

Set your API key once via an environment variable (or pass --api-key):

export BOUNCEBUSTER_API_KEY=bb_live_your_key_here

Verify addresses

Verify one or more addresses (up to 100 per command). Add --json for machine-readable output.

bouncebuster verify [email protected]
bouncebuster verify [email protected] [email protected] --json

Clean a file

Point it at a .csv, .tsv, or .txt file. Bouncebuster extracts and de-duplicates every address, verifies the list, then writes the deliverable (valid) addresses to --out. Use --all to also save each category (valid, invalid, catch-all, disposable, unknown) to a folder.

bouncebuster clean contacts.csv --out cleaned.csv
bouncebuster clean contacts.csv --all ./results

Check your account

bouncebuster account

Run the MCP server

The same package ships a Model Context Protocol server for AI agents. See the MCP docs for client configuration.

bouncebuster mcp