E-mail

Find a person's e-mail address

Find the work e-mail address of a person from their name and company domain, verified against the mail server.

POST/v1/email/find

MCP tool find_emailscope email:find2 records per address found

Parameters

domainstringrequired

first_namestringoptional

last_namestringoptional

full_namestringoptional

positionstringoptional

linkedinstringoptional

What your agent reads

The tool description exactly as an MCP client receives it in tools/list — it doubles as the full behaviour of the endpoint.

Find the work e-mail address of a person from their name and company domain, verified against the mail server. Answers within ~30 s; if the provider is slow you get {status:'pending', task_id} — call get_email_result with it. result: valid (deliverable) · invalid · catch_all (the domain accepts everything — not provable) · unknown · unreachable (the domain does not accept mail: no MX, or its mail server does not answer) · not_found (no mailbox for that name) · skipped (the provider blocks verification from our network for now). For many people at once use start_email_job.

Errors follow one format.

Request

curl -X POST "https://api.breaknorm.co/v1/email/find" \
  -H "Authorization: Bearer $BREAKNORM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "Anna",
    "last_name": "Schmidt",
    "domain": "acme.de"
  }'