# Hyrule Cloud MX Bounce Parse

> Hyrule Cloud MX Bounce Parse is a paid API for AI agents from cloud.hyrule.host, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Parses a raw email bounce or NDR message and classifies the failure reason with probable causes and recommended remediation actions

## Facts

- Endpoint: POST https://cloud.hyrule.host/v1/mx/bounce/parse
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyrule-cloud-mx-bounce-parse-9b48bfe7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uiJpynGVMVenDuRz_1fo8

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 hyrule-cloud-mx-bounce-parse-9b48bfe7 -d '<json body>'
```

Example prompt: I just got a bounce-back email from my mail server — here's the raw NDR text: 'Your message to user@example.com was not delivered... 550 5.7.1 SPF check failed'. Can you parse it and tell me why it bounced, what classification it falls under, and what I should do to fix it?

## When to prefer this

Use this endpoint when you need structured, machine-readable analysis of a raw email bounce or NDR message — especially when you need to programmatically route remediation (e.g. retry vs unsubscribe vs fix DNS records) based on the classification. Prefer it over regex-based parsing or manual inspection when dealing with variable bounce formats from different mail servers. Particularly valuable when auth failure vs policy rejection distinction matters for automated workflows.

## Known failure modes

- Empty or whitespace-only message body returns a validation error
- Message exceeding 262144 characters is rejected
- Malformed or non-bounce message may return classification 'unknown' with no probable causes
- Missing required 'message' field returns a schema validation error
- Unrecognized DSN format may yield low-confidence results with generic recommendations

## How this service works

Full-stack network infrastructure for AI agents on AS215932 (RIPE): IPv6-native VMs with SSH and automatic HTTPS subdomains, domain registration and DNS, a broad network-intelligence suite (BGP/routing, IP/ASN & reputation, DNS, RDAP/WHOIS, web & deep TLS, mail deliverability, port/NAT/CGNAT, VoIP/SIP), and proxied requests over Direct/Tor/I2P/Yggdrasil. Pay per request in USDC on Base via x402; VM checkout may also accept BTC/XMR when advertised. This OpenAPI document intentionally contains only the launch-ready, independently payable agent surface.

## Output

A JSON object with a diagnostic status (ok/info/warning/critical/error), a bounce classification enum (policy_rejection, auth_failure, mailbox_full, rate_limited, dns_failure, tls_failure, unknown), the remote MTA hostname if present, the raw SMTP status code, a list of probable causes, a list of recommended remediation actions, an evidence map with supporting details, and a generated_at timestamp.

## Request schema (JSON Schema)

```json
{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "type": "string",
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ]
    },
    "bodyType": {
     "type": "string",
     "enum": [
      "json",
      "form-data",
      "text"
     ]
    },
    "body": {
     "properties": {
      "message": {
       "maxLength": 262144,
       "minLength": 1,
       "title": "Message",
       "type": "string"
      },
      "context": {
       "properties": {
        "sender_domain": {
         "anyOf": [
          {
           "type": "string"
          },
          {
           "type": "null"
          }
         ],
         "default": null,
         "title": "Sender Domain"
        },
        "recipient_domain": {
         "anyOf": [
          {
           "type": "string"
          },
          {
           "type": "null"
          }
         ],
         "default": null,
         "title": "Recipient Domain"
        }
       },
       "title": "MailBounceContext",
       "type": "object"
      }
     },
     "required": [
      "message"
     ],
     "title": "MailBounceParseRequest",
     "type": "object"
    }
   },
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "status": {
       "enum": [
        "ok",
        "info",
        "warning",
        "critical",
        "error"
       ],
       "title": "DiagnosticStatus",
       "type": "string"
      },
      "classification": {
       "enum": [
        "policy_rejection",
        "auth_failure",
        "mailbox_full",
        "rate_limited",
        "dns_failure",
        "tls_failure",
        "unknown"
       ],
       "title": "MailBounceClassification",
       "type": "string"
      },
      "smtp_status": {
       "anyOf": [
        {
         "type": "string"
        },
        {
         "type": "null"
        }
       ],
       "default": null,
       "title": "Smtp Status"
      },
      "remote_mta": {
       "anyOf": [
        {
         "type": "string"
        },
        {
         "type": "null"
        }
       ],
       "default": null,
       "title": "Remote Mta"
      },
    
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "status": "warning",
  "classification": "auth_failure",
  "recommended_actions": [
   "Check SPF, DKIM, and DMARC alignment"
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyrule-cloud-mx-bounce-parse-9b48bfe7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from cloud.hyrule.host](https://www.zero.xyz/host/cloud.hyrule.host/llms.txt)