Find work emails for a list of people
argorant_find_emailsFind work emails for a list of up to 1,000 people per call, each with first name, last name, company domain and an optional ref of your own. Use it for more than 5 people; for one person use argorant_find_email, and to check addresses the user already has use argorant_quote_verification. Each person costs 1 credit when an email is found and confirmed, and 1 credit when the company's domain accepts every address (catch-all). In that case the most likely address is returned and marked unconfirmed. It costs 0.25 credits when nothing is found. Nothing is charged for invalid input, for a domain that does not exist or cannot receive email, or when the check cannot be finished right now (status retry_later). Credits are the account's shared credits. Before calling, tell the user how many people there are, the price for each result and the most it can cost (people times the found price), and ask the user to approve a spending limit, passed as max_credits. The list runs in the background and never spends more than max_credits. It pauses at that limit (resume with a higher one through argorant_manage_find_emails), when the account runs out of credits, or at the daily lookup limit (it continues after midnight UTC), and it slows down by itself when most lookups find nothing. Duplicates are removed and rows without a usable name or domain are skipped for free (invalid_rows). The answer has job_id, status, totals and maximum_charge at once; call argorant_find_emails_status about every 30 seconds for progress and results, which are also in the Argorant app (app_url) as a table and a CSV download. More in the docs at https://docs.argorant.com/docs/agents/tools#find-work-emails
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"people": "<people>",
"max_credits": "<max_credits>"
},
"name": "argorant_find_emails"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | A label for the list, e.g. 'Q4 accounts' | |
| people | Yes | The people to look up, as [{first_name, last_name, domain, ref?}] | |
| max_credits | Yes | Spending limit in credits the user approved for this list |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |