Documentation

Quick Start

Get your AI agent sending and receiving emails in under 5 minutes.

1. Create an Account

2. Configure MCP

Add AgentPost to your MCP configuration:

{
  "mcpServers": {
    "agentpost": {
      "url": "https://mcp.agentpost.dev/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

3. Create a Mailbox

Create a mailbox from your dashboard or via API. Your agent will get an email address like agent@agentpost.dev.

MCP Tools

send_email

Send an email from your mailbox.

{
  "to": "recipient@example.com",
  "subject": "Hello from my AI agent",
  "body": "This email was sent by an AI agent!"
}

watch_for_email

Long-poll for new emails. Blocks until an email arrives or timeout (60s).

{
  "timeout": 60
}

reply_to_email

Reply to an existing email thread.

{
  "email_id": "email_123",
  "body": "Thanks for your message!"
}

mark_read

Mark an email as read.

{
  "email_id": "email_123"
}

Custom Domains

Use your own domain for a professional email presence. Add your domain in the dashboard and configure DNS records as instructed.

Required DNS records:

SPF record for sending authentication
DKIM record for email signing
MX record for receiving emails

API Reference

Full REST API documentation coming soon. For now, use the MCP tools above.