CLI Reference
Commands
| Command | Description |
|---|---|
check <domain> | DNS health check (SPF/DKIM/DMARC/MX/PTR) |
verify <email> | SMTP mailbox verification |
blacklist <ip> | RBL blacklist scan (29 lists) |
report <domain> | Full diagnostic report |
probe <domain> | SMTP latency measurement |
serve | Start HTTP server |
pool | IP pool management |
disposable | Disposable email list management |
Global Flags
| Flag | Default | Description |
|---|---|---|
--format | text | Output format: text, json, md |
--timeout | 60s | Connection timeout |
Check Command
smtp-probe check <domain> [flags]| Flag | Default | Description |
|---|---|---|
--format | text | Output format |
Verify Command
smtp-probe verify <email> [flags]| Flag | Default | Description |
|---|---|---|
--bind-ip | (outbound IP) | Source IP for SMTP connection |
--timeout | 60s | SMTP timeout |
--disposable | false | Check disposable email providers |
--pool | false | Use IP pool with auto-failover |
--format | text | Output format |
Blacklist Command
smtp-probe blacklist <ip> [flags]| Flag | Default | Description |
|---|---|---|
--format | text | Output format |
Report Command
smtp-probe report <domain> [flags]| Flag | Default | Description |
|---|---|---|
--format | text | Output format: text, json, md |
Probe Command
smtp-probe probe <domain> [flags]| Flag | Default | Description |
|---|---|---|
--pool | false | Probe from each IP in pool |
Serve Command
smtp-probe serve [flags]| Flag | Default | Description |
|---|---|---|
--port | 8080 | HTTP server port |
--node-id | (auto) | Node identifier (multi-node) |
--region | — | Region name (multi-node) |
--lat | 0 | Latitude |
--lon | 0 | Longitude |
--peers | — | Peer addresses (comma-separated) |
--heartbeat | 30s | Peer heartbeat interval |
Pool Subcommands
| Command | Description |
|---|---|
pool add <ip> [--domain] | Add IP to pool |
pool remove <ip> | Remove IP from pool |
pool list | List all IPs and their status |
pool check [ip] | Health check (RBL scan) for pool IPs |
Disposable Subcommands
| Command | Description |
|---|---|
disposable list | List sources and status |
disposable download [sources] | Download named sources or --all |
disposable update | Update stale lists (>7 days old) |
disposable update --install-cron | Install daily crontab job |