# Hermes Plant EmailGuard Validate

> Hermes Plant EmailGuard Validate is a paid API for AI agents from hermesplant.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Validates an email address for RFC5322 syntax, typo detection, disposability, role-based classification, and deliverability scoring

## Facts

- Endpoint: GET https://hermesplant.com/api/agent-services/emailguard/validate
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hermes-plant-emailguard-validate-bf48ed54
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rKzMB4If6ziKV-mRjcRl9

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability hermes-plant-emailguard-validate-bf48ed54
```

Example prompt: Check whether alice@gnail.com is a valid, deliverable email address — I want to know if it's a typo, whether it's disposable or role-based, and what its deliverability score is.

## When to prefer this

Use this endpoint when you need deterministic, rule-level email validation with explicit per-check evidence rather than a simple pass/fail — especially when typo detection, disposable-provider screening, role-based classification, and a numeric deliverability score are all needed in a single call. Prefer this over generic syntax checkers when the agent needs structured audit trails per check rule.

## Known failure modes

- Missing or malformed request body returns a 4xx error
- Empty or null email field causes validation failure
- Network timeout on DNS-based checks may delay or error response
- Unusual Unicode or internationalized email formats may not be fully supported
- Payment failure over x402 returns 402 with no result

## How this service works

Deterministic email and contact data quality scorer. Returns validity, deliverability score, risk level, normalized form, classifications, and per-rule diagnostics. Pure function, no network calls.

## Output

Returns a JSON object with a top-level 'valid' boolean, an array of per-rule check results (each with rule name, pass/fail, severity, evidence, and optional fix suggestion), an overall riskLevel (e.g. 'medium'), a normalized object with canonical address, localPart, and domain, a classification object indicating whether the address is role-based, disposable, free provider, or a typo candidate, and a numeric deliverabilityScore (0–100).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "name": {
   "type": "string",
   "description": "Optional contact name associated with the email."
  },
  "email": {
   "type": "string",
   "description": "The email address to validate and score."
  },
  "domain": {
   "type": "string",
   "description": "Optional explicit domain hint (usually derived from email)."
  },
  "mxPresent": {
   "type": "boolean",
   "description": "Caller-supplied hint whether the domain has MX records. Never performs DNS itself."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "valid": true,
  "checks": [
   {
    "fix": null,
    "why": "Email must contain a valid local part and domain with a dot.",
    "pass": true,
    "rule": "rfc5322-syntax",
    "evidence": "parsed local=alice domain=gnail.com",
    "severity": "info"
   },
   {
    "fix": "Use alice@gmail.com instead.",
    "why": "Domain is close to a popular provider and may be a typo.",
    "pass": false,
    "rule": "typo-suggestion",
    "evidence": "input domain=\"gnail.com\" suggestion=\"gmail.com\"",
    "severity": "warn"
   }
  ],
  "riskLevel": "medium",
  "normalized": {
   "domain": "gnail.com",
   "canonical": "alice@gnail.com",
   "localPart": "alice"
  },
  "classification": {
   "roleBased": false,
   "disposable": false,
   "freeProvider": false,
   "typoSuggestion": "gmail.com"
  },
  "deliverabilityScore": 55
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hermes-plant-emailguard-validate-bf48ed54/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from hermesplant.com](https://www.zero.xyz/host/hermesplant.com/llms.txt)