# MAIL_UNDELIVERABLE

**What it means.** The email could not be sent.

**What to do.** Check the address for a typo, then try again. Nothing about the app itself is affected — this is only the email.

- HTTP status: 502
- Retryable after applying the fix: yes

Every failure from the CLI or an MCP tool has this shape:

```json
{
  "ok": false,
  "code": "MAIL_UNDELIVERABLE",
  "message": "The email could not be sent.",
  "fix": "Check the address for a typo, then try again. Nothing about the app itself is affected — this is only the email.",
  "file": "<where to edit, when known>",
  "retryable": true,
  "docs": "https://docs.uarpie.app/errors/MAIL_UNDELIVERABLE"
}
```

Apply `fix` (edit `file` when it is given), then run the same command again.
