AgentPost exposes a Model Context Protocol (MCP) server so AI agents can create mailboxes, read emails, send messages, and manage custom domains — all through a standard tool-calling interface. MCP in plain terms: MCP is an open standard that lets AI agents call tools hosted on a server, the same way a human uses an API. Your agent describes what it wants, and the server executes it and returns structured results. No scraping, no custom integrations.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.
Endpoint
| Property | Value |
|---|---|
| URL | /mcp |
| Protocol | JSON-RPC 2.0 via HTTP POST |
| Authentication | Bearer token |
| Rate limit | 60 requests per minute per token |
Discovery
- Machine-readable:
/.well-known/mcp.json— for MCP clients that auto-discover tools - Human/AI-readable:
/mcp/docs— browsable documentation for the full tool schema
Available tools
CreateMailbox
Create a new temporary mailbox. Optionally specify a verified custom domain to enable outbound sending.
ListMailboxEmails
List all emails in a mailbox, with optional body inclusion and thread grouping.
ReadEmail
Read the full content of a specific email, including attachments metadata.
DeleteEmail
Permanently delete a specific email message.
DeleteMailbox
Delete a mailbox and all its messages.
WaitForEmail
Wait for an email to arrive, streaming progress every 2 seconds until the message is received or the timeout expires.
DownloadAttachment
Download a specific email attachment by its UUID as base64-encoded content.
ListThreads
List conversation threads in a mailbox, sorted by latest activity with cursor-based pagination.
ReadThread
Read all messages in a conversation thread in chronological order.
AddDomain
Add a custom domain to your account and get DNS records to configure.
ListDomains
List all custom domains and their verification and sending status.
VerifyDomain
Trigger DNS verification for a domain. Passes the domain into warmup once all checks pass.
RemoveDomain
Remove a custom domain from your account.
SendEmail
Send an outbound email from a mailbox on a verified custom domain.
Typical use cases
Sign-up verification: Create a mailbox → use the address to sign up for a service → callWaitForEmail → extract the verification link from the response.
Outbound email automation: Add and verify a custom domain → create a mailbox on it → call SendEmail to queue delivery.
Inbox monitoring: Call ListMailboxEmails to scan for messages, ReadEmail to read specific ones, and ListThreads + ReadThread to follow full conversations.
Cleanup after automation: Call DeleteEmail to remove individual messages or DeleteMailbox to tear down the entire inbox when your workflow completes.