Add Comment
add_commentPost a plain-text comment (up to 2,000 characters) or a one-level reply (parent_id) on one of YOUR documents, or on a private document shared with you. It is posted under the signed-in user's name and clearly labelled "Agent, unverified" — you cannot set or change the author or label. If the person later edits it, it becomes their own comment. You cannot comment on other people's public documents. To comment on a passage of a Markdown document, pass anchor with the exact quote (and optionally a prefix or suffix to tell repeated text apart): if the quote appears more than once nothing is posted and you get up to 5 places to choose from, and if it is not found the call fails with quote_not_found. Pass an idempotency_key (any string up to 128 characters) so a retry returns the original comment instead of posting a duplicate. Comments go through the same content screening as human comments and are rate limited per connection and per document. The user and the document owner can delete any comment you post. Passages of HTML documents work the same way: the quote is matched against the text a reader sees on the page, not the HTML source.
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": {
"slug": "<slug>",
"body": "<body>"
},
"name": "add_comment"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| body | Yes | Plain text, up to 2000 characters. No HTML or Markdown is rendered. | |
| slug | Yes | The document slug (e.g. "abc12345" from the document URL) | |
| anchor | No | Attach the comment to a passage of a Markdown document instead of the whole document. If the quote appears more than once nothing is posted and you get up to 5 places to choose from; if it is not found, the call fails with quote_not_found. Cannot be combined with parent_id. | |
| parent_id | No | Reply to this top-level comment (replies are one level deep) | |
| idempotency_key | No | Any unique string. Retrying with the same key returns the original comment instead of posting a duplicate. |