read_messages
Fetch messages addressed to an agent or broadcast to all, optionally filtered by type or timestamp. Marks retrieved messages as read so they are not returned again.
Instructions
Read messages for an agent. Returns messages addressed to this agent or broadcast to all. Marks them as read.
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_name": "<agent_name>"
},
"name": "read_messages"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | Filter by message type | |
| since | No | Only messages after this ISO timestamp | |
| agent_name | Yes | The agent reading messages | |
| unread_only | No | Only return unread messages (default: false) |