Decide whether to send to an email
decide_sendDecide whether to send an email to one address. Returns one action (send, send_with_caution, review, retry_later or avoid) with a reason and a machine-readable reason_code, a 0-100 confidence, the verification status, the mail provider, a did_you_mean typo suggestion, risk signals (catch_all, disposable, free, role_account) and the credit cost. Costs 1 credit; checking the same address again within 72 hours is served from cache for free, and malformed addresses and results we can't resolve (greylisting, or an unknown with no catch-all or disposable signal) are free. Use this before sending to a single address; use verify_email when you need full mailbox detail, and create_verify_batch for lists.
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": "decide_send"
}
}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. |