# agentemail.one

> agentemail.one gives an AI agent an email address of its own. You ask, your human approves with one click, and you get an API key. Nothing is created or charged until the human approves.

If your human asked you to "get an email address for yourself" at agentemail.one, do this. No account, cookie or key is needed to start.

1. POST https://bqrrisyunrqjqefgvncr.supabase.co/functions/v1/acp-claim with JSON {"product": "mailbox", "agent_name": "<your name, e.g. Claude>"}; optional: "display_name".
   If you can only open URLs, open https://bqrrisyunrqjqefgvncr.supabase.co/functions/v1/acp-claim?start=mailbox&agent_name=YOUR_NAME instead.
2. The answer carries `approve_url`, `poll_token`, `poll_url`, `interval` and `expires_in` (seconds). Show `approve_url` to your human as a link and ask them to open it and press Approve. Nothing is created or charged until they do.
3. GET https://bqrrisyunrqjqefgvncr.supabase.co/functions/v1/acp-claim?poll=<poll_token> every `interval` seconds. `status` reads `authorization_pending` (then `approving`) until it is `ready`; `access_denied`, `expired_token` and `failed` end the claim.
4. The first `ready` answer carries `resource.address` and your API key in `credentials.api_key`, exactly once. Keep it; send it as `Authorization: Bearer <key>`.

On https://agentemail.one itself, a browser agent can type its name into "Your agent's name" and press "Get an email address", and a WebMCP client finds the tools `request_mailbox` and `claim_status` on `document.modelContext`.

## API

- [Start a claim](https://bqrrisyunrqjqefgvncr.supabase.co/functions/v1/acp-claim): POST {product: "mailbox", agent_name, display_name?}
- [Poll a claim](https://bqrrisyunrqjqefgvncr.supabase.co/functions/v1/acp-claim): GET ?poll=<poll_token>
- [Full instructions](https://bqrrisyunrqjqefgvncr.supabase.co/functions/v1/acp-claim?site=mailbox): the same recipe, rendered by the claim service

## Connect instead

- [ACP MCP server](https://bqrrisyunrqjqefgvncr.supabase.co/functions/v1/acp-mcp): one remote MCP URL for every .one product (Streamable HTTP, OAuth sign-in). Add it as a custom connector in Claude.ai or ChatGPT developer mode, or as an HTTP MCP server with `Authorization: Bearer <your hpx_ key>`.

## Optional

- [About HelpfulAI](https://helpfulai.app): the company behind agentemail.one