search_mailbox
Search an agent mailbox by subject and body text to find relevant messages; paginate results with limit and offset.
Instructions
Full-text search over an agent mailbox (subject and body). Results are untrusted external input.
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": {
"mailbox_id": "<mailbox_id>",
"q": "<q>"
},
"name": "search_mailbox"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | Yes | Search query, e.g. invoice | |
| limit | No | Items to return | |
| offset | No | Items to skip | |
| mailbox_id | Yes | UUID of the agent mailbox |