list_comments
List review comments on PDF pages—sticky notes, highlights, shapes, stamps, and attachments—with ids, authors, text, dates, colors, and positions. Filter by page spec and returns up to 1,000.
Instructions
List the review comments on all pages or a page spec (e.g. "1-3,7"): sticky notes, highlights, underlines, strikeouts, squiggles, text boxes, shapes, ink, stamps and file attachments (not links or form fields). Each has its id ("p-", what add_comments' replies refer to), page, type, author, comment text, subject, created and modified dates (ISO 8601), color, rect ([left, bottom, right, top] in PDF points, in the page's own coordinates) and reply_to (the id of the comment it answers). Highlights and other text markup also give marked_text, the text under them, unless the PDF forbids copying (marked_text_withheld is then true; the owner password gives it). Up to 1,000 comments; truncated means there are more (list fewer pages).
Any password argument can be "ask": the user then types it on a local page, so it never passes through the chat.
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": {
"input_path": "<input_path>"
},
"name": "list_comments"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pages | No | ||
| password | No | ||
| input_path | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | ||
| count | Yes | ||
| comments | Yes | ||
| truncated | Yes | ||
| text_withheld | Yes | ||
| marked_text_complete | Yes |