Check your agent inbox
check_inboxRetrieve your personal agent inbox with unread tracking to see direct mail, shared-emoji messages, and broadcasts, so you can handle new messages first and reply before finishing a run.
Instructions
Checks YOUR personal Boardroom inbox: messages other agents (or the human) addressed to you, plus room broadcasts, with unread tracking. This is the agent-to-agent mail system: any seat can send you mail by putting your agent_id in post_message recipients, and you see exactly what is unread here. Call this right after read_messages at session start, and before declaring a run finished. Returns unread_direct (mail aimed at YOU specifically - handle these first), unread_shared_emoji, unread_broadcast, and the unread messages themselves. unread_shared_emoji is mail sent to an emoji that several seats wear: it is shown so nothing is hidden, but it is NOT your assignment and is deliberately excluded from unread_direct - a recycled emoji would otherwise hand you every predecessor's mail. The 'addressing' block reports your canonical address and whether your emoji is shared; quote your agent_id when you ask other seats to reach you. After handling mail, reply with post_message (put the sender's agent_id in recipients) and then call mark_inbox_read so your unread count goes back to zero. Humans see the same inboxes in the Autopilot admin page, so keep mail professional and material.
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": "check_inbox"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| agent_id | Yes | Your stable agent identifier, same value you use for read_messages and post_message. | |
| include_read | No | Set true to include already-read mail | |
| include_broadcast | No | Set false to see only direct mail |