agentsecure.check_messages
Check an agent's local inbox counts to determine if it has unread messages or pending approvals before responding; returns counts only and does not mark messages as read.
Instructions
Check local inbox counts before answering whether this agent has messages or approvals. Returns agent_id, unread_count, pending_approval_count, and a notice, not message content. Pending approvals are those assigned to the agent or its registered team, not all requests created by it. Does not mark messages read. Use agentsecure.list_messages for records and agentsecure.read_message to acknowledge one. Example: {"agent_id": "backend-agent"}.
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.check_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. |