> ## 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.

# Quick Start

> Create your first mailbox and receive an email in under two minutes.

## Using the web UI

<Steps>
  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.

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

  <Step title="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.

    <Warning>
      Deletion is irreversible. All messages in a deleted mailbox are permanently removed.
    </Warning>
  </Step>
</Steps>

## 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.

<Steps>
  <Step title="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](/authentication) for details.
  </Step>

  <Step title="Connect your agent">
    Add AgentPost to your agent's MCP configuration:

    ```json theme={null}
    {
      "mcpServers": {
        "agentpost": {
          "url": "https://agent.agentpost.email/mcp",
          "headers": {
            "Authorization": "Bearer YOUR_TOKEN_HERE"
          }
        }
      }
    }
    ```
  </Step>

  <Step title="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.
  </Step>
</Steps>

<Note>
  The MCP API supports 14 tools covering mailboxes, messages, threads, domains, and outbound sending. See the [MCP API tab](/mcp/overview) for the full reference.
</Note>