comms_unread_bodies
Retrieve unread message bodies for your instance, ordered oldest first. Use this to read actual messages not yet acknowledged, complementing unread counts.
Instructions
Return the actual message bodies — not just counts — that instance_id has not yet acknowledged via read_by. Default order is ascending (oldest first) so you read your siblings in the order they spoke. Complements /api/comms/unread which returns only counts.
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": {
"instance_id": "<instance_id>"
},
"name": "comms_unread_bodies"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| instance_id | Yes | Your instance identifier. | |
| channel | No | general | |
| limit | No | ||
| order | No | asc |