inbox-poll
Read messages from a receive-only agent inbox — Returns the emails and webhook deliveries that arrived in an inbox you created with inbox-create, oldest first, with sender, subject, selected headers, a plain-text body (up to 64 KB per message in the response) and a sha256 of the stored body. Filter by since (inclusive), kind, limit up to 100; mark_consumed hides the returned messages from later polls unless include_consumed is true. It does not
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": "inbox-poll"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | Default all. | |
| limit | No | Default 50. | |
| since | No | Only messages received at or after this time: epoch milliseconds or ISO 8601 (UTC when no offset). Inclusive, so dedupe by id or use mark_consumed. | |
| inbox_id | Yes | ||
| tenantId | No | Required for API-key callers (namespace as key:<tenantId>; keep it unguessable). Ignored when a wallet paid. | |
| mark_consumed | No | Mark the returned messages consumed. Default false. | |
| include_consumed | No | Also return consumed messages. Default false. |