Tool
create_disposable_mailbox
Create a disposable mailbox
SurfacesChat agentMCPCLI
Mint a throwaway email address and a pollToken to read its mail with poll_disposable_mailbox. Ideal for grabbing a one-time code (OTP) without touching a real inbox. By default the ADDRESS is kept (a catch-all keeps routing its mail) and the TOKEN never expires — pass expiresIn (e.g. '2h', '30m', '7d') to expire the token, and expireAddress:true to also tear the address down at that time.
CLI: tinbox create-disposable-mailboxParameters
| Name | Type | Required | Description |
|---|---|---|---|
expiresIn | string | no | Friendly token lifetime, e.g. '2h', '30m', '90s', '7d', '1h30m'. Omit ⇒ the pollToken never expires. Clamped to 5min–30d. |
expireAddress | boolean | no | If true, the ADDRESS is destroyed when the token expires (only meaningful with expiresIn). Default false: keep the address — the catch-all route keeps mail flowing. |
label | string | no | Optional human label, e.g. 'acme-signup' — shown in the mailbox list. |