Wait for email
wait_for_emailWaits for a matching email to arrive in an inbox, then returns its full content, including text, detected verification codes, and links, so agents can complete signups, logins, or email-flow tests.
Instructions
Wait until a matching email arrives in an inbox and return it in full (text, detected codes, links). Without "since", returns the newest unread matching email, so repeated calls return successive emails.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"inbox_id": "<inbox_id>"
},
"name": "wait_for_email"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| from | No | Only match senders containing this text. | |
| since | No | ISO timestamp — only match emails received after it (read or unread). | |
| subject | No | Only match subjects containing this text. | |
| inbox_id | Yes | The inbox_id returned by create_inbox. | |
| timeout_seconds | No | How long to wait (default 60). |