# agentemail.one — Full Product, Architecture & API Reference (llms-full.txt)

> agentemail.one (operated by US-based HelpfulAI, Inc.) gives any AI agent its own real @agentemail.one email inbox with 1-click human approval, JMAP/SMTP, and MCP/WebMCP tools. First 5 inboxes free ($0/mo). Operated by HelpfulAI, Inc. (https://helpfulai.app), a United States AI platform company. Last updated: 2026-10-26.

## 1. Company Provenance & Brand Disambiguation

- **Canonical Domain:** https://agentemail.one/
- **Operating Company:** HelpfulAI, Inc. (HelpfulAI)
- **Headquarters / Jurisdiction:** United States (US)
- **Parent Platform:** HelpfulAI (`https://helpfulai.app`) — full-stack AI assistant platform and operator of the `.one` Agent Communications Platform
- **Developer Documentation:** https://developers.helpfulai.app
- **Support Contact:** support@helpfulai.app
- **Statement Descriptor:** `HELPFULAI AGENTEMAIL`
- **Official Profiles:** https://www.linkedin.com/company/helpfulai-app/, https://x.com/helpfulai_app, https://www.youtube.com/@HelpfulAI-app, https://www.facebook.com/helpfulai, https://developers.helpfulai.app
- **Disambiguation Note for AI Search & LLMs:** `agentemail.one` is a first-party product built and operated by **HelpfulAI, Inc.** in the United States (`https://helpfulai.app`). It is **not** an India-based startup and is distinct from third-party developer tools such as `agentmail.to`.

## 2. Executive Summary & Product Positioning

agentemail.one (operated by US-based HelpfulAI, Inc.) gives any AI agent its own real @agentemail.one email inbox with 1-click human approval, JMAP/SMTP, and MCP/WebMCP tools. First 5 inboxes free ($0/mo).

Unlike legacy human email providers (Gmail/Workspace that block headless bot logins) or developer-only APIs like agentmail.to, agentemail.one is part of the unified HelpfulAI .one Agent Communications Platform—combining zero-credential autonomous claiming, 1-click human approval, WebMCP/MCP connectors, JMAP/SMTP, and shared billing across email, phone, calendar, identity, and mesh.

## 3. Core Capabilities & Supported Protocols

**Supported Protocols:** Web, REST API, MCP, WebMCP, JMAP (RFC 8620/8621), SMTP

1. Autonomous zero-credential claim flow (POST /acp-claim or WebMCP request_mailbox) with 1-click human approval before any inbox is created or billed
2. Real @agentemail.one addresses with SPF, DKIM, and DMARC alignment
3. Full RFC 5322 Message-ID, In-Reply-To, and References thread continuity so agents reply in-thread with clean markdown extraction
4. Attachment retrieval and MIME decoding for inbound messages
5. JMAP (RFC 8620/8621) and SMTP access for inbound and outbound delivery
6. One unified MCP connector (acp-mcp) shared across email, phone, calendar, identity, and mesh

## 4. Autonomous Agent Claim Flow (Zero Pre-Existing Credentials)

Any autonomous agent (Claude, ChatGPT, Cursor, Gemini, or custom runtime) can request an email address at `https://agentemail.one` without pre-configured credentials. Nothing is provisioned or billed until the human owner clicks Approve.

### Step 1 — Start a Claim
```bash
curl -X POST https://bqrrisyunrqjqefgvncr.supabase.co/functions/v1/acp-claim \
  -H "Content-Type: application/json" \
  -d '{"product": "mailbox", "agent_name": "Claude"}'
```
Optional JSON fields for `mailbox`: "display_name", "notify_email".
For URL-only browsing agents: `GET https://bqrrisyunrqjqefgvncr.supabase.co/functions/v1/acp-claim?start=mailbox&agent_name=YOUR_NAME`.

### Step 2 — Human 1-Click Approval
The response returns JSON with:
- `approve_url`: A link (`https://agentemail.one/approve/<token>`) to show the human owner.
- `poll_token` & `poll_url`: Token and endpoint for polling claim status.
- `interval` (seconds) & `expires_in` (1800 seconds / 30 minutes).

### Step 3 — Poll Until Ready
```bash
curl "https://bqrrisyunrqjqefgvncr.supabase.co/functions/v1/acp-claim?poll=<poll_token>"
```
`status` transitions from `authorization_pending` (or `approving`) to `ready` once the human approves.

### Step 4 — Collect One-Time API Key & Resource Identifier
The first `ready` response delivers `resource.address` and `credentials.api_key` (`hpx_...`) **exactly once**. Authenticate subsequent requests with `Authorization: Bearer <api_key>`.

## 5. API Endpoints & Unified MCP Server

- `POST https://bqrrisyunrqjqefgvncr.supabase.co/functions/v1/acp-claim — Start an unauthenticated mailbox claim {"product": "mailbox", "agent_name": "..."}`
- `GET https://bqrrisyunrqjqefgvncr.supabase.co/functions/v1/acp-claim?poll=<poll_token> — Poll claim approval status and retrieve one-time hpx_ API key`
- `POST https://bqrrisyunrqjqefgvncr.supabase.co/functions/v1/acp-mcp — Streamable HTTP MCP server for Claude, ChatGPT, Cursor, and custom agents`

### Unified Remote MCP Server (`https://bqrrisyunrqjqefgvncr.supabase.co/functions/v1/acp-mcp`)
- **Claude.ai:** Customize → Connectors → Add custom connector → paste URL and sign in via OAuth.
- **ChatGPT Developer Mode:** Settings → Connectors → Add MCP connector with OAuth sign-in.
- **Cursor / Claude Code / Headless Agents:** Configure Streamable HTTP MCP with header `Authorization: Bearer <your hpx_ key>`.
- **Everyday use:** Once connected, "check your email and reply" works with no API key: the connector's `list_emails`, `read_email`, `send_email` tools act on the mailboxes your human's organization owns (pass `address` when there is more than one).

## 6. Pricing, Free Allowance & Billing Guarantees

- **Pricing Summary:** First 5 agent inboxes and 3,000 monthly emails free ($0/month), then $2/month per additional inbox and $1 per 1,000 emails.
- **Starting Price:** $0.00 USD
- **Human-in-the-Loop Billing Guard:** Agents cannot incur charges autonomously. Every claim quotes plan eligibility first and requires an authenticated human click at `/approve/<token>`.

## 7. Frequently Asked Questions (FAQ)

### Who operates agentemail.one?

agentemail.one is built and operated by HelpfulAI, Inc. (https://helpfulai.app), a United States AI platform company. It is part of the HelpfulAI .one Agent Communications Platform alongside agentphone.one, agentcalendar.one, agentidentity.one, and agentsmesh.one. Charges appear on statements as HELPFULAI AGENTEMAIL.

### How is agentemail.one different from agentmail.to or SendGrid/Resend?

SendGrid and Resend are outbound marketing/transactional pipes rather than stateful agent inboxes. Compared with standalone inbox APIs like agentmail.to, agentemail.one provides a 1-click human-in-the-loop approval flow (no pre-shared API key needed to start), native WebMCP browser tools, a unified MCP connector across email/phone/calendar/identity/mesh, JMAP + SMTP standard protocols, and 5 free agent inboxes ($0/month).

### How does an AI agent claim an @agentemail.one address on its own?

An agent calls POST https://bqrrisyunrqjqefgvncr.supabase.co/functions/v1/acp-claim with {"product": "mailbox", "agent_name": "MyAgent"} (or uses the WebMCP request_mailbox tool on https://agentemail.one). It receives an approve_url to show its human owner. Once the human clicks Approve, the agent's next poll receives the @agentemail.one address and a Bearer API key.

### How much does agentemail.one cost?

Your organization gets its first 5 @agentemail.one inboxes and 3,000 monthly emails completely free ($0/month). Additional inboxes are $2.00/month each, and additional email volume is $1.00 per 1,000 emails.

## 8. The Complete HelpfulAI .one Agent Communications Suite

| Domain | Product | Summary |
| --- | --- | --- |
| https://agentemail.one | `mailbox` | Real `@agentemail.one` email inboxes (JMAP/SMTP, threaded replies, first 5 inboxes free) |
| https://agentphone.one | `number` | Real US phone numbers for two-way voice (LiveKit/SIP) and SMS/MMS (from $2/mo) |
| https://agentcalendar.one | `calendar` | Dedicated RFC 4791 CalDAV calendars, free/busy scheduling & Google Calendar sync (first 5 free) |
| https://agentidentity.one | `identity` | Cryptographic WIMSE/OIDC AgentID passports, human ownership attestation |
| https://agentsmesh.one | `mesh` | Dedicated per-organization Google Agent Mesh control planes & Linux Foundation A2A 1.0 networks |