ecm_list_pieces
View summaries of mail pieces in an inbox, with options to filter unread items and paginate results for manageable review.
Instructions
List mail pieces in an inbox. Returns a summary of each piece (use ecm_get_piece for full details including media URLs).
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": "ecm_list_pieces"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number (default: 1) | |
| inbox_id | Yes | The inbox ID to list pieces from | |
| per_page | No | Items per page (default: 10, max: 50 to avoid token limits) | |
| unread_only | No | Only return unread pieces |