{"uid":"cap_uiJpynGVMVenDuRz_1fo8","slug":"hyrule-cloud-mx-bounce-parse-9b48bfe7","name":"Hyrule Cloud MX Bounce Parse","description":"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.","url":"https://cloud.hyrule.host/v1/mx/bounce/parse","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","title":"MailBounceParseRequest","required":["message"],"properties":{"context":{"type":"object","title":"MailBounceContext","properties":{"sender_domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sender Domain","default":null},"recipient_domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recipient Domain","default":null}}},"message":{"type":"string","title":"Message","maxLength":262144,"minLength":1}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","title":"MailBounceParseResponse","required":["status","classification"],"properties":{"status":{"enum":["ok","info","warning","critical","error"],"type":"string","title":"DiagnosticStatus"},"evidence":{"type":"object","title":"Evidence","additionalProperties":true},"remote_mta":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Remote Mta","default":null},"smtp_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Smtp Status","default":null},"generated_at":{"type":"string","title":"Generated At","format":"date-time"},"classification":{"enum":["policy_rejection","auth_failure","mailbox_full","rate_limited","dns_failure","tls_failure","unknown"],"type":"string","title":"MailBounceClassification"},"probable_causes":{"type":"array","items":{"type":"string"},"title":"Probable Causes"},"recommended_actions":{"type":"array","items":{"type":"string"},"title":"Recommended Actions"}}}}}}},"responseSchema":{"type":"json","example":{"status":"warning","classification":"auth_failure","recommended_actions":["Check SPF, DKIM, and DMARC alignment"]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_UX0U_AUbtJGcK_vso1yDq","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Parses a raw email bounce or NDR message and classifies the failure reason with probable causes and recommended remediation actions","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Diagnose SPF auth failure bounces","prompt":"I'm getting bounce messages back from several recipients that mention authentication issues. Here's one of the raw bounce messages — can you parse it and tell me if it's an SPF, DKIM, or DMARC problem and what steps I should take to fix it?"},{"title":"Triage full mailbox vs hard bounces","prompt":"My sending agent got this NDR back after trying to deliver to a client: [raw bounce text here]. Can you classify whether this is a permanent hard bounce like a bad address, or a temporary issue like a full mailbox, and tell me the recommended action?"},{"title":"Automated bounce handling in email pipeline","prompt":"We have a batch of raw bounce messages from our outbound mail queue. For this one, parse it and tell me the classification — policy rejection, rate limit, DNS failure, or something else — plus the SMTP status code and what our system should do next."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:37:27.541Z","isFirstParty":false}