Email Suitability Decision
email_suitability_decisionEvaluate whether an email address is suitable for a specified use case using syntax, MX, SPF, DMARC, disposable-domain, and role-account signals. Decision for observed evidence; external DNS evidence may change between calls. Returns an ALLOW, REVIEW, or REJECT decision with deliverability score, risk level, confidence, checks, and reasons. Does not send email, probe the mailbox via SMTP, verify that the mailbox exists or is owned by a specific person, or guarantee delivery. Read-only DNS lookups may affect latency or availability; no tool-specific rate limit. USE WHEN: an agent needs to decide whether an email address is suitable for outbound sales, account signup, transactional email, CRM import, lead qualification, or another supported use case. DO NOT USE WHEN: the agent needs domain-level risk and trust assessment or proof that a mailbox exists. USE domain_risk_trust_decision FOR: domain-level risk and trust assessment.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| Yes | Email address for suitability decision. | ||
| use_case | No | Intended sending context; when provided, the decision accounts for context-specific risk. Omitted for a baseline decision without contextual adjustments. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| Yes | Validated email address (domain-lowercased). | ||
| valid | Yes | Backward-compatible validity summary based on deliverability score >= 60. Does not prove mailbox existence or delivery. | |
| checks | Yes | Per-signal check results keyed by check name: syntax, domain, mx, spf, dmarc, disposable, role_account. Each value is a machine-readable result string (e.g. 'syntax:valid', 'mx:found', 'spf:pass', 'disposable:no'). Partial when a DNS lookup is unavailable. | |
| domain | Yes | Lowercased domain part. | |
| reasons | Yes | Machine-readable reason codes explaining the decision and corresponding to observed checks. | |
| decision | Yes | Context-aware suitability decision for the given use case. | |
| mx_found | No | Backward-compatible MX result; null means lookup unavailable. | |
| use_case | No | The validated use case echoed from the input; null when omitted. Affects contextual decision adjustments such as role-account tolerance and SPF/DMARC weighting. | |
| confidence | Yes | Confidence in the decision from 0 to 100. | |
| risk_level | Yes | Risk level derived from observed signals. | |
| deliverability_score | Yes | Deliverability score from 0 to 100. |