verify_email
Verify one email address and return its verdict, score, and per-check results, waiting up to about 8 seconds for the job. Its mailbox field says whether the mail server confirmed the mailbox itself: a valid address at Microsoft or Yahoo, which are not asked, or at a catch-all domain, which accepts every address, is unconfirmed. Use it for a single address or a few; for 20 or more addresses use submit_batch, which is built for lists. If the job is still running it returns a job_uuid and a note: then call get_verification with that job_uuid instead of resubmitting. The optional checks list picks which checks run (syntax, mx, smtp, disposable, role, free, catchall). Each check is billed at its own price, returned by get_pricing. Omitting checks runs every check your plan allows, which is the most reliable answer and costs the most tokens; naming fewer costs less. A check outside your plan is refused. Requires the email:verify:single scope.
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": {
"email": "<email>"
},
"name": "verify_email"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| Yes | Email address to verify. | ||
| checks | No | Optional check wire strings (syntax, mx, smtp, disposable, role, free, catchall). Each check is billed at its own price (see get_pricing). Omit to run every check your plan allows, the most reliable answer and the most tokens; naming fewer costs less. A check outside your plan is refused. smtp brings mx, and catchall brings smtp and mx. | |
| idempotency_key | No | Optional idempotency key so repeated calls replay the same job. |