paperclip_list_comments
List comments on an issue with pagination and optional cursor-based incremental fetching to retrieve new comments since a known ID.
Instructions
List comments on an issue, with optional cursor-based incremental fetching.
Args:
issueId: string — Issue ID or identifier (example: "PAP-42")
after: string (optional) — Comment UUID cursor; returns only comments after this ID (client-side workaround active — server after param returns 500)
order: "asc" | "desc" (optional) — Sort order (default: asc)
limit: number (optional) — Max comments per page (1–100, default 50)
offset: number (optional) — Number of comments to skip (default 0)
response_format: 'markdown' | 'json' (optional) — Output format (default: markdown)
Returns:
Pagination envelope { items: Comment[], total, count, offset, limit, has_more, next_offset }. When after is used, total reflects the filtered (post-cursor) count.
Examples:
Use when: reading new @-mention comments since the last heartbeat using the
aftercursorDon't use when: you need a single comment by ID — use paperclip_get_comment instead
Error Handling:
401: authentication failed → check PAPERCLIP_API_KEY
404: issue not found → verify ID with paperclip_list_issues
500: server error on the
aftercursor path → tool automatically applies a client-side workaround
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| issueId | Yes | Issue ID or identifier (e.g. PAP-21) | |
| after | No | Comment ID cursor — returns only comments posted after this ID. Note: the server-side `after` param is broken (returns 500); this tool implements a client-side workaround. | |
| order | No | Sort order (default: asc) | |
| limit | Yes | Max comments per page (1–100, default 50) | |
| offset | Yes | Number of comments to skip (default 0) | |
| response_format | Yes | Output format: 'markdown' (default, human-readable) or 'json' (structured) | markdown |