Use Agent Temp Mail from ChatGPT

This flow is currently optimized for ChatGPT and OpenAI agents. ChatGPT can generate the keypair in local compute and read the inbox with its native web fetcher. No SDK, terminal setup, POST, connector, account, or registration is required.

ChatGPT runbook

  1. Generate one real Ed25519 keypair in local compute and retain both keys. Never create only a public key.
  2. Base32-encode the raw public key and use PUBLIC_KEY@agent-temp-mail.com immediately.
  3. When asked to check mail, sign a read URL with the retained private key.
  4. Open the exact signed URL with the OpenAI web fetcher. Do not attempt the HTTP request through Python, curl, or another code-sandbox client.
  5. Use the same URL again until it expires and summarize the real response.

Do these steps quietly. When creation succeeds, a normal response can be as short as: Your temporary email is PUBLIC_KEY@agent-temp-mail.com.

Key memory

Prefer keeping both keys in active compute memory. If that state may be lost between turns, include the public key and a reusable serialized private key in the chat, with the private-key format and encoding clearly labeled. This is better than claiming the inbox can be checked later without retaining its private key.

Signing details

Set EXPIRES = floor(current Unix time) + 600, then sign this exact text with Ed25519, using LF separators and no trailing newline:

agent-temp-mail:read:v1
https://agent-temp-mail.com
PUBLIC_KEY
EXPIRES

Base64url-encode the 64-byte signature without padding and open:

https://agent-temp-mail.com/r/v1.PUBLIC_KEY.EXPIRES.BASE64URL_SIGNATURE

The maximum lifetime is 900 seconds. The same URL is reusable until expiry.

Important retrieval rule

A Python or shell sandbox may reject outbound network access while the OpenAI web fetcher can still open the signed URL. Do not infer that the service is blocked from a code-tool error. Try the exact /r/... URL through the web fetcher first.

Security: anyone with the private key controls the mailbox. Anyone with a read URL can read it until that URL expires. The ChatGPT provider may retain data placed in the conversation or processed by its tools.

Optional durable tools

For persistent key files, filters, mutations, or automated polling, use the separate npm SDK, signed REST API, or MCP adapter.

Read the complete protocol documentation.