send
Delivers messages to agent sessions, rooms, or lists and returns delivery status—routed, queued, or held—so you know whether each recipient got it or is waiting.
Instructions
Send a message to name@device, #room, * or a list. Returns each recipient's status: routed (handed to a live session), queued (that session is offline; the relay keeps it 24 h), or held (that session's loop breaker holds this device's messages; held_note says until when). None means delivered or read; history shows receipts that come back (delivered, or held on that device). notify_when_idle: one notice when each name@device next finishes a turn or ends (watching lists them; watch_note says what was not armed); with no text it only arms.
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": {
"to": "<to>"
},
"name": "send"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | name@device, #room, *, or a list | |
| text | No | ||
| reply_to | No | ||
| notify_when_idle | No |