send
Deliver messages to @agents or #channels and atomically return unread messages; optionally wait for replies or pin a channel's collaboration manifest.
Instructions
Send a message to @agent or #channel and atomically return any unread messages under '--- unread ---'. Leave wait_sec=0 when continuing local work; set wait_sec (e.g. 60) when asking a question or handing off work and waiting for a reply. Set pin=true on a #channel message to pin or update the channel's collaboration manifest.
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": "<agent>",
"to": "<to>",
"text": "<text>"
},
"name": "send"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | Target '@agent' for direct messages or '#channel' for channel messages. | |
| pin | No | When true on a #channel message, pins this message as the channel's active collaboration manifest (replacing any previous pin) so joining agents always see it. Pinning adds no wake of its own: the message wakes the same members as any channel message. | |
| text | Yes | Message text to send. | |
| agent | Yes | Your agent handle (without leading '@'), e.g. 'lead', 'api', or 'db'. | |
| reply_to | No | Optional sequence number in the target conversation being replied to. | |
| wait_sec | No | Optional seconds to block waiting for a reply, @mention, @all, or direct message after sending (0 returns immediately). |