Comment Tools

Manage comments on issues and epics via MCP — add, update, and delete.

Every tool here names the comment's subject with exactly one of issue_id, issue_key or epic_id. A call with none of them, or with more than one, is refused with Provide exactly one of issue_id, issue_key or epic_id.

add-comment

Add a comment to an issue or an epic.

Parameters

Parameter	Type	Required	Description
issue_id	integer	One of	The numeric ID of the issue
issue_key	string	One of	The issue key, e.g. "KD-0042"
epic_id	integer	One of	The ID of the epic
content	string	Yes	Comment text (max 10,000 characters)
parent_id	integer	No	The comment to reply to. It must be a top-level comment on the same issue or epic: a reply to a reply, to a comment elsewhere or to a deleted comment is refused

Behavior

• The authenticated user is automatically recorded as the comment author
• A plain @Full Name (or unique first name) of a project member becomes a real mention and notifies that member — no need to know their numeric ID. Ambiguous or unknown names stay literal text, and names inside code blocks are never matched
• A mention notifies in the app and by mail, with a link to the issue or the epic
• A comment on an issue notifies the issue's watchers. Epics have no watchers, so a comment on an epic notifies only the members it mentions
• Returns the created comment with ID, content, author, parent_id (null for a top-level comment), issue and epic (the subject as { "id", "title" }, the other null), and created_at/updated_at (ISO 8601)

Example Prompt

Add a comment to the email validation bug: "Root cause identified — the email regex doesn't allow plus signs"

Comment on the Checkout epic: "@Grace the Done when list is ready for your review"

update-comment

Edit an existing comment on an issue or an epic.

Parameters

Parameter	Type	Required	Description
issue_id	integer	One of	The numeric ID of the issue
issue_key	string	One of	The issue key, e.g. "KD-0042"
epic_id	integer	One of	The ID of the epic
comment_id	integer	Yes	The ID of the comment to update
content	string	Yes	The new comment text (max 10,000 characters)

Behavior

• Requires Comments: Update permission (Own scope: own comments only, All scope: any comment)
• The comment is looked up under the subject you name, so the ID of a comment on another issue or epic is not found
• Read kendo://issues/{id}, or get-epics with an epic_id, first to find comment IDs
• Returns the updated comment with ID, content, author, issue and epic, and created_at/updated_at (ISO 8601)

Example Prompt

Update comment #5 on KD-42 to say "Root cause confirmed — the regex needs to allow plus signs"

delete-comment

Permanently delete a comment from an issue or an epic.

Destructive

This action cannot be undone. The comment and its attachments are permanently removed.

Parameters

Parameter	Type	Required	Description
issue_id	integer	One of	The numeric ID of the issue
issue_key	string	One of	The issue key, e.g. "KD-0042"
epic_id	integer	One of	The ID of the epic
comment_id	integer	Yes	The ID of the comment to delete

Behavior

• Requires Comments: Delete permission (Own scope: own comments only, All scope: any comment)
• The comment is looked up under the subject you name, so the ID of a comment on another issue or epic is not found
• Read kendo://issues/{id}, or get-epics with an epic_id, first to find comment IDs
• Returns confirmation with the deleted comment's ID, content, and issue_id or epic_id (the other null)

Example Prompt

Delete comment #3 on KD-42, it was posted on the wrong issue

See Also

• Resources — Read comments via kendo://issues/{id} (includes full comment history)
• Epic Tools — Read an epic's comments via get-epics with an epic_id
• Comments API — REST endpoints for comment management