CleanMyList

Confirm and run a job (debits credits). Starts or reruns an existing workspace job and queues processing. Verification consumes the workspace plan allowance, then credits; any configured enrichment also consumes credits. Uses the list's existing verification or enrichment settings and may contact recipient mail servers or enrichment providers. Review the job and authorize usage before calling. Ready, completed, cancelled, or failed jobs can run when their prerequisites are satisfied; an active run returns 409. Retrying after completion can start another billable run.

start_verification_job

Create a bulk verification job. Creates and stores a job from up to 1,000,000 addresses (maximum 25 MB inline) or downloads a CSV from the supplied public URL. Supply addresses or url; addresses take precedence. Queues free analysis of duplicates and invalid syntax. Poll get_verification_job until analysis is ready, then review it before authorizing start_verification_job. Creation does not spend verification credits.

create_verification_job

Download job results. Results for a job's completed run, as CSV (default) or JSON. Page through large lists with offset and limit; JSON caps at 1000 rows per call. Returns 409 until a run has completed. Read-only — spends no credits.. MCP defaults: format=json

get_verification_job_results

Get a job's status and analysis. Poll this after creating a job to watch the free pre-billing analysis complete, and again after starting it to follow progress via run.percent_complete. Read-only — spends no credits.

get_verification_job

List recent verification jobs. Up to 50 recent verification jobs in the connected workspace, newest first, each with its analysis, run progress, and result download links. Read-only — spends no credits.

list_verification_jobs

Verify a single address. Real-time verification for one address — the call to put in a signup or checkout form. Returns a verdict (deliverable, risky, undeliverable, unknown), a 0-100 confidence score, the reason code behind it, every individual check that ran, and a typo suggestion when the domain looks mistyped. Records the result and consumes one verification from the workspace plan allowance, or one credit when no allowance remains. Set smtp_probe: false to skip the mailbox check for a faster, less certain answer; usage cost is unchanged. Verification may query DNS and recipient mail servers but does not send an email. A verdict does not guarantee delivery. Shares synchronous capacity with bulk verification; when busy, returns 429 with Retry-After: 60 without verifying or charging.

verify_email

Verify up to 100 addresses synchronously. Verifies 1 to 100 supplied addresses, records each result, and consumes one verification per address from the workspace plan allowance, then credits. Optional SMTP probing contacts recipient mail servers without sending an email. Disabling smtp_probe does not reduce usage cost. Returns an address and verdict for each input; verdicts do not guarantee delivery. Single and bulk synchronous verification share two slots per web process. When busy, returns 429 with Retry-After: 60 without verifying or charging. For larger lists or sustained batch traffic, create a verification job and review its analysis before starting it.

verify_emails