create_inbox
Open an email inbox and get a permanent address for signups or one-time codes. Reuse the same address across test runs; only messages expire based on retention.
Instructions
Open an email inbox and return its address. Use this when you need an address to sign up for a service or to receive a one-time code.
The address is permanent and stays until you delete it, so a test suite can reuse one address across runs instead of opening a new inbox each time. Only the messages inside expire, on the retention window you choose.
label needs a paid plan; on free it is reported back in ignored_fields.
retention_hours is optional (0 = your plan's max); requests above your plan are capped.
subdomain picks the part after the @ on mailflat.net (prefix@subdomain.mailflat.net);
it needs a paid plan and is random when omitted.
domain opens the inbox on a custom domain instead (prefix@acme.com). Pass it ONLY when
the user named a domain they have already verified on this account; never guess one. Leave
it empty and the address is created on mailflat.net. domain wins over subdomain.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "create_inbox"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| label | No | ||
| domain | No | ||
| prefix | No | ||
| subdomain | No | ||
| retention_hours | No |