> ## Documentation Index > Fetch the complete documentation index at: https://docs.agentpost.email/llms.txt > Use this file to discover all available pages before exploring further. # Message Tools > MCP tools for reading, waiting for, deleting, downloading attachments from, and sending email messages. ## ReadEmail Reads the full content of a specific email message. You must own the message's mailbox. **Inputs** The UUID of the message to read. Response format for message content. Options: `text`, `html`, `html2text`. Defaults to `"html2text"`. * `html2text` — HTML converted to clean readable text preserving links and structure. Recommended for AI agents (minimal tokens, preserves structure). * `text` — original plain text part. * `html` — both plain text and full HTML content. **Output** The message UUID. Email subject line. Sender address. List of recipient addresses. List of CC addresses. ISO 8601 timestamp of when the email was sent. Message body in the requested format. When using `html` format, `html_content` is also included. The conversation thread this message belongs to. Total number of messages in the thread. When greater than `1`, call `ReadThread` to see the full conversation. Whether the message has any attachments. Number of attachments on the message. List of attachment metadata. Each item includes `id`, `filename`, `mime_type`, and `size`. Use the `id` with `DownloadAttachment` to retrieve file content. *** ## WaitForEmail Waits for a new email to arrive in a mailbox, streaming progress notifications while waiting. Only detects emails that arrive after the tool is called. **Inputs** The mailbox email address to wait for. Maximum number of seconds to wait. Must be between 5 and 120. Defaults to `30`. Response format for message content. Options: `text`, `html`, `html2text`. Defaults to `"html2text"`. **Output when an email arrives** Always `"received"` when an email arrived within the timeout period. The message UUID. Email subject line. Sender address. List of recipient addresses. List of CC addresses. ISO 8601 timestamp of when the email was sent. Message body in the requested format. The conversation thread this message belongs to. Call `ReadThread` to see the full conversation context. Whether the message has any attachments. Number of attachments on the message. **Output when the timeout is reached** Always `"timeout"` when no email arrived within the timeout period. The email address that was monitored. Number of seconds the tool waited before timing out. A human-readable description of the timeout. The tool streams `notifications/progress` events every 2 seconds so your agent receives confirmation it is still running. If you need to wait longer than 120 seconds, call `WaitForEmail` again after it returns. *** ## DeleteEmail Deletes a specific email message. You must own the message's mailbox. This action is irreversible. The message cannot be recovered after deletion. **Inputs** The UUID of the message to delete. **Output** Always `true` when the message was successfully deleted. The UUID of the deleted message. *** ## DownloadAttachment Downloads a specific email attachment and returns its content as base64. You must own the attachment's mailbox. **Inputs** The UUID of the attachment to download. Obtain attachment IDs from the `attachments` array in a `ReadEmail` response. **Output** The attachment UUID. Original filename of the attachment. MIME type of the attachment (e.g., `"application/pdf"`). File size in bytes. Base64-encoded file content. Attachments larger than 10 MB return an error. Download large files directly from the AgentPost web interface instead. *** ## SendEmail Sends an outbound email from a mailbox on a verified custom domain. The message is queued for delivery asynchronously. The sending mailbox must exist on a custom domain in `active` or `pending_warmup` status. Domains in warmup are limited to 10 emails per day; active domains are limited to 50 emails per day (configurable). Exceeding the daily quota returns an error. **Inputs** The full email address of the sending mailbox (e.g., `"sales@example.com"`). The mailbox must exist on a verified custom domain you own. Array of recipient email addresses. Email subject line. Maximum 998 characters. Plain text body of the email. HTML body for multipart emails. When provided, recipients see HTML with the plain text `body` as a fallback. Message-ID of the email you are replying to. Threads the outbound message as a reply in the recipient's email client. Array of attachment objects to include with the email. Maximum 20 attachments per message. Each object must include: * `filename` (string) — the file name (e.g., `"report.pdf"`) * `mime_type` (string) — MIME type (e.g., `"application/pdf"`) * `content_base64` (string) — base64-encoded file content Per-attachment size limit: **25 MB**. Total attachment size limit: **25 MB**. CC and BCC are not currently supported. Only direct recipients via the `to` field are accepted. **Output** Unique identifier for the queued message. Always `"queued"` when the message was accepted for delivery. Number of attachments included with the message.