add_comment
Adds comments to tasks, supports threading and internal notes, and reports if @-mentions actually reached each recipient's queue or notification.
Instructions
Add a comment to a task. Response is lean by default: id/author/created_at and the delivery report, without echoing the body you just sent; full=true returns the whole comment. If the body @-mentions someone, the response carries a delivery array — one entry per mentioned handle — reporting whether it actually reached a path they consume (their task queue, a notification) or was skipped/failed and why; a hint field suggests the fix when there is one (e.g. assign the task). Omitted entirely when the comment mentions nobody.
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": {
"task_id": "<task_id>",
"body": "<body>"
},
"name": "add_comment"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| body | Yes | Comment body (markdown supported). | |
| full | No | Return the whole created comment (body echo included) instead of the lean confirmation. | |
| task_id | Yes | Task ID. | |
| metadata | No | Additional metadata as key-value pairs. Set {"informational": true} on a comment you write on a task that is ALREADY done/cancelled when your comment needs no action from its assignee — a plain acknowledgement, "noted", "nothing further from me" — to stop the server's own follow-up-card mechanism from opening one for it. Omit it (default: not flagged) for anything that names a problem, asks a question, or reports a finding — an unflagged comment on a closed card still opens a follow-up as before, so forgetting the flag costs nothing. The flag is IGNORED if your comment also contains a `❓ Blocking @<person>` marker: a live ask to a human is never suppressed by this field. | |
| is_internal | No | Mark as internal (agent-only visible). | |
| parent_comment_id | No | Parent comment ID for threading. |