Quick Start

Using the web UI

Create an account

Go to AgentPost and sign up with your name, email address, and a password. After registration, verify your email address — AgentPost sends a verification link to the address you provided. You must verify before you can create mailboxes.

Create a mailbox

From the dashboard, click New Mailbox. AgentPost generates a unique address in the format adjective.noun-NN@agent.agentpost.email — for example, calm.brook-42@agent.agentpost.email.The confirmation page shows your new address with a Copy button. Your mailbox is live immediately.

Share your address

Copy the address and use it anywhere — sign up for a service, trigger a transactional email in your app, or send a test message from your own email client.

Read incoming email

New messages appear in your mailbox in real time. Click any message to open the full view: HTML rendering, sender details, recipients, and attachments.

The dashboard shows the latest 50 messages across all your mailboxes. Use the sidebar to filter by a specific mailbox.

Delete when done

To clean up, delete individual messages from the message view, or delete the entire mailbox from the sidebar. Deleting a mailbox permanently removes all its messages.

Deletion is irreversible. All messages in a deleted mailbox are permanently removed.

Using the MCP API (for AI agents)

If you’re building an agent workflow, you can skip the web UI entirely. The MCP API lets agents create mailboxes, wait for email, and read messages programmatically.

Generate an API token

In the web UI, go to Settings → API Tokens, enter a name for your token, and click Create. Copy the token immediately — it’s shown only once.See Authentication for details.

Connect your agent

Add AgentPost to your agent’s MCP configuration:

{
  "mcpServers": {
    "agentpost": {
      "url": "https://agent.agentpost.email/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

Create a mailbox and wait for email

Your agent can now call CreateMailbox to get a fresh address, then call WaitForEmail to block until a message arrives:

CreateMailbox → { email_address: "calm.brook-42@agent.agentpost.email" }
WaitForEmail(email_address, timeout=60) → { status: "received", subject: "Verify your account", ... }

The WaitForEmail tool streams progress notifications every 2 seconds while waiting, so your agent knows it’s still running.

The MCP API supports 14 tools covering mailboxes, messages, threads, domains, and outbound sending. See the MCP API tab for the full reference.

Get Started

Mailboxes

Sending Email

MCP API

REST API

Account

Using the web UI

Using the MCP API (for AI agents)

​Using the web UI

​Using the MCP API (for AI agents)

Using the web UI

Using the MCP API (for AI agents)