agentsecure.list_messages
Lists messages addressed to a specific agent in the local Community Mesh store, returning newest-first metadata for unread or all messages without marking them read.
Instructions
List messages addressed to one agent in the local Community Mesh store. Returns agent_id and a messages array, newest first (empty if none). Each record includes message_id, sender/recipient, subject, resource, status, thread IDs, and timestamps. Body is [redacted]; body_summary may retain up to 120 characters and body_sha256 is a digest, not recoverable full content. Does not mark messages read. Use agentsecure.check_messages for counts only or agentsecure.read_message to mark a specific record read. Example: {"agent_id": "backend-agent", "include_read": true}.
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": {
"agent_id": "<agent_id>"
},
"name": "agentsecure.list_messages"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| agent_id | Yes | Non-empty Mesh agent ID, e.g. backend-agent. Pass this session's AGENTSECURE_AGENT_ID value when set; it is not read automatically. IDs are caller-supplied local labels, not authentication credentials. | |
| include_read | No | Defaults to false (unread only). True includes already-read messages as well; neither setting marks messages read. |