Skip to main content
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.

​
Endpoint

PropertyValue
URL/mcp
ProtocolJSON-RPC 2.0 via HTTP POST
AuthenticationBearer token
Rate limit60 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 → call WaitForEmail → 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.