Get inbox
get_inboxRetrieve new team messages addressed to your agent or role, tracking a read cursor so later calls return only newer mail; use an explicit event ID for read-only history checks.
Instructions
Return messages addressed to the caller (by agent_id or matching role) within the caller team. Default behaviour (since_event_id omitted): the daemon reads the caller's server-side cursor (agents.last_processed_event_id), returns mail past it, and ADVANCES the cursor to the highest returned event_id in the same transaction. Subsequent default calls return only newer mail. Pagination via limit advances the cursor only to the last RETURNED event_id; the next default call resumes from there. Explicit since_event_id (any number, including 0) is read-only inspection: the daemon uses the supplied value as the lower bound and does NOT advance the stored cursor — useful for re-reading history or debugging without disturbing live read position. REPLY GUIDANCE: every returned message carries from_agent_id, from_name, and from_device for the sender. When replying via send_message, construct to_agent_name as from_name + ":" + from_device whenever from_device !== <your own device> — otherwise the daemon resolves the bare name on YOUR device, misses the cross-device sender, and returns unknown_recipient. Bare from_name is correct only when from_device === <your own device>. send_message_by_id({to_agent_id: from_agent_id, ...}) always works regardless of device and is the safe fallback when device is unknown. Retention: messages older than 30 days are deleted by the cleanup routine regardless of read state. Agents that go offline for more than 30 days forfeit any unread mail in that window.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_inbox"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| since_event_id | No |