# List Comments

`lawmatics_list-comments` · Lawmatics MCP tool · Comments

List comments on a Lawmatics task with optional pagination, newest first. Rows carry the comment body, @mentioned user IDs, and a `relationships` envelope of to-one {id,type} pointers (commentable parent task); use get-comment for the full envelope including comment_mentions.

## Input

- **taskId** `string` (required, pattern: ^\d+$) — ID of the parent task whose comments to list; a numeric string
- **page** `integer` (> 0) — Page number (1-based)

## Output

- **comments** `array` (required) — Comments on this page of results
  - **[]** `object`
    - **id** `string` (required) — Unique ID of the comment
    - **body** `string` (required) — Text content of the comment; may contain HTML formatting and mention spans
    - **mentionedUserIds** `array` (required) — Numeric IDs of the firm users @mentioned in the comment
      - **[]** `integer`
    - **createdAt** `string` (required) — When the comment was created, as an ISO 8601 timestamp
    - **updatedAt** `string` (required) — When the comment was last updated, as an ISO 8601 timestamp
    - **relationships** `object` (required) — To-one JSON:API relationship pointers as {id,type} stubs. Not materialized — follow a pointer by calling that resource's own tool. List rows carry to-one pointers only; use get-comment for the full envelope incl. comment_mentions.
      - **commentable** `object | null` (required) — Parent record this comment is attached to (typically a task) pointer; null when unset
        - **id** `string` (required) — ID of the referenced Lawmatics record
        - **type** `string` (required) — JSON:API record class of the reference (e.g. "user", "contact", "prospect", "firm"); resolve it by calling that resource's own get/find tool — this pointer is not materialized
- **pagination** `object` (required) — Pagination metadata derived from the API `meta` envelope
  - **totalPages** `number` (required) — Total number of pages available
  - **limitPerPage** `number` (required) — Maximum comments returned per page
  - **totalEntries** `number` (required) — Total number of comments across all pages