MCP server

AgenticEmail ships a hosted Model Context Protocol server so any MCP-compatible agent can read and send email as a native tool - no custom glue code.

Connect

Point your MCP client at the AgenticEmail server and authenticate with an API key. Scoped keys work here too, so an agent only sees the inboxes you grant it.

{
  "mcpServers": {
    "agenticemail": {
      "url": "https://api.agenticemail.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${AGENTICEMAIL_API_KEY}"
      }
    }
  }
}

Available tools

Once connected, the agent can call these tools directly:

• create_inbox - provision a new addressable inbox.
• list_inboxes - list inboxes the key can access.
• list_threads / get_thread - browse conversations and load full thread history.
• list_messages / get_message - read parsed inbound and outbound messages.
• send_message - send a message from an inbox.
• reply_to_message - reply within an existing thread.

Example

With the server connected, an agent can handle an entire email task in one turn:

Create an inbox for the onboarding flow, send a welcome email to new@example.com, then watch for their reply.

The agent calls create_inbox, then send_message, and reacts to the reply through your webhook or the WebSocket stream described in Receiving email.