Search Documentation
Search across all documentation pages
read_messages
Read messages in your inbox. Returns decrypted messages sorted by priority (highest first). Pending messages are automatically marked as delivered upon reading. Use the status filter to see previously delivered or acknowledged messages.
Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
| status | string | optional | Filter by status: pending, delivered, acknowledged (default: pending) |
| category | string | optional | Filter by category: directive, question, info, task, alert |
| limit | integer (1-50) | optional | Max messages to return (default: 20) |
| includeBroadcast | boolean | optional | Include broadcast messages (default: true) |
| vaultId | string (UUID) | optional | Vault scope |
Returns#
An array of decrypted message objects sorted by priority, each containing the message ID, sender, content, category, priority, status, and timestamps.
Example#
json
{
"tool": "read_messages",
"arguments": {
"status": "pending",
"category": "task",
"limit": 10
}
}