List emails
list_emailsFind email messages newest first, filtering by status, sender, recipient, tag, domain, date, or search term; use cursor paging to retrieve all matching results.
Instructions
Purpose: find messages, newest first. Filter by status, sender, recipient (to, cc or bcc), tag, domain or a search string — the same filters GET /emails takes. NOT for: analytics or counting — it pages rows, it does not aggregate. Returns: data, has_more, and next_cursor. Page again by passing next_cursor as cursor; when has_more is false you have everything.
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": "list_emails"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Search the subject, a recipient, or the start of the message id. | |
| to | No | Only mail whose to, cc or bcc contains this address. | |
| tag | No | name:value, for example campaign:welcome. Only mail carrying that tag. | |
| from | No | Only mail from this address. The display name is ignored. | |
| limit | No | Page size (1-100). | |
| since | No | Only mail created at or after this instant (ISO-8601). | |
| until | No | Only mail created at or before this instant (ISO-8601). | |
| cursor | No | next_cursor from the previous page. Omit for the first page. | |
| domain | No | Only mail sent from this domain. | |
| status | No | Only return emails in this state. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | This page of rows. | |
| error | No | Present instead of the fields above when the call was refused: code, message, fix, docs_url, retryable and, when waiting helps, retry_after_seconds. | |
| has_more | No | True when another page follows. | |
| next_cursor | No | Pass back as cursor for the next page; null on the last page. |