List hygieneFree

clean_email_list

Clean an email list

Dedupe, drop invalid syntax, and optionally strip disposable and role accounts — no verification, free.

Get an API key + 100 free credits Connect the MCP server

When an agent uses clean_email_list

Use clean_email_list as the cheap first pass before spending credits on verification. It dedupes, removes malformed addresses, and can strip disposable and role accounts, so an agent can shrink a raw list down to the addresses actually worth verifying. It performs no mailbox checks and costs no credits — pair it with verify_batch or submit_bulk for the deliverability pass.

REST endpoint

POST /api/v1/clean

Credit cost

Free

Input schema

Field	Type	Required	Description
`emails`	string[]	required	Email addresses to clean (at least one).
`remove_disposable`	boolean	optional	Remove disposable/throwaway addresses. Default true.
`exclude_role_accounts`	boolean	optional	Remove role accounts like info@, support@. Default false.

Call it over MCP

An MCP client invokes the tool with a tools/call request. Hosted clients send this to https://verifly.email/mcp with your Authorization: Bearer vf_… header; the verifly-mcp-server package does the same with VERIFLY_API_KEY set.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "clean_email_list",
    "arguments": {
      "emails": [
        "a@test.com",
        "a@test.com",
        "info@company.com"
      ],
      "exclude_role_accounts": true
    }
  }
}

Posting that same call straight to the hosted endpoint:

curl -s -X POST "https://verifly.email/mcp" \
  -H "Authorization: Bearer vf_your_api_key" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"clean_email_list","arguments":{"emails":["a@test.com","a@test.com","info@company.com"],"exclude_role_accounts":true}}}'

Equivalent raw REST call

Under the hood this tool calls POST /api/v1/clean. If you are not using MCP, hit the REST API directly:

curl -s -X POST "https://verifly.email/api/v1/clean" \
  -H "Authorization: Bearer vf_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"emails":["a@test.com","a@test.com","info@company.com"],"options":{"exclude_role_accounts":true}}'

What you get back

A JSON object with original_count, cleaned_count, removed_count, the cleaned emails array, and a stats breakdown (duplicates, invalid_format, public_domains, role_accounts).

Required input: emails.

Related tools

extract_emails

Pull every email address out of a block of free-form text, optionally deduped and lowercased. Free.

Open verify_batch

Synchronously verify a small list (up to a few hundred) and get a verdict per address in one call.

Open submit_bulk

Queue a large list (up to 1M) as an async job — returns a job_id to poll. Optional completion webhook.

Open

Use clean_email_list in your agent

Verifly is the only email verifier with a hosted MCP server plus autonomous agent self-registration. An agent can call register_account for an instant key and 100 free credits, then start calling clean_email_list — no human, no dashboard.

Connect the MCP server Read the agent guide