mailbox_join
Register a client as a role in a local mailbox, subscribe its agent ID to role and project topics, and bind the MCP session so separate CLI agents can exchange durable messages.
Instructions
Join the mailbox as the holder of a role: register this client's agent id (- by default), subscribe it to role. and any project topics, and bind the MCP session. Claude Code can also confirm live push; other clients use the mailbox tools to poll.
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": {
"role": "<role>"
},
"name": "mailbox_join"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| role | Yes | Role this session holds, e.g. reviewer | |
| agent | No | Agent id override; defaults to claude-<role> | |
| project | No | Project names to subscribe to as project.<name> |