Verify one email address
verify_emailVerify one email address and return the full result: status (valid, invalid, unknown, temporary_unavailable), deliverable and reachable flags, catch_all, disposable, free and role_account signals, confidence, a reason code (such as mailbox_not_found, catch_all, greylisted or probe_blocked), the mail provider and MX hosts, the mail server's SMTP reply code as evidence, a did_you_mean typo suggestion, plus the same recommended action decide_send gives. Costs 1 credit; repeats within 72 hours come from cache for free, a malformed address is rejected without charge, and a result we can't resolve is free. Use decide_send instead when you only need the send decision.
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 | The email address to check, for example jane@example.com. | ||
| strictness | No | How cautious the recommended action is. default: catch-all domains get review. aggressive: catch-all domains get send_with_caution. strict: as default, and role addresses such as info@ or sales@ also get review. Defaults to default. | |
| force_refresh | No | Skip the 72-hour cache and verify again now. Costs 1 credit even when a cached result exists. Defaults to false. |