send
Transmit a message from one agent to another, persist it in a durable mailbox, and optionally push a live notice to the recipient so they see it without polling.
Instructions
Send a message from one agent to another.
Always persists to the durable mailbox. If deliver is true, also pushes
a one-shot notice to the recipient via its native mechanism (hermes chat /
codex exec / claude -p) so it sees the message without polling.
from_agent/to_agent are one of: claude, hermes, codex; an unknown
agent is rejected. Returns {"ok": true, "message_id", "created_at"}
(plus delivery when deliver set), or {"ok": false, "error"}.
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": {
"from_agent": "<from_agent>",
"to_agent": "<to_agent>",
"message": "<message>"
},
"name": "send"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| deliver | No | ||
| message | Yes | ||
| to_agent | Yes | ||
| from_agent | Yes |