add-comment-to-work-item-tool

Adds a plain-text comment to a work item's timeline. The comment appears in the in-app activity feed alongside human-added comments. The author is the user who minted the MCP token. HTML mentions are not parsed through this tool.

Inputs

Name	Type	Required	Description
`work_item_key`	string	yes	Issue key of the work item (e.g. `ACM-123`).
`body`	string	yes	Comment body. 1–10000 characters.

Permissions

project_management::manage_work_items (entry permission).
The user must also be allowed to manage the target work item by WorkItemPolicy.

Example

{
  "work_item_key": "ACM-123",
  "body": "Blocked on legal review — see thread in #compliance."
}

Response

{
  "id": 9002,
  "body": "Blocked on legal review — see thread in #compliance.",
  "body_markdown": "Blocked on legal review — see thread in #compliance.",
  "author": { "id": 4, "name": "Tomáš Horák", "email": "tomas@example.com" },
  "created_at": "2026-05-20T10:01:33+00:00",
  "updated_at": "2026-05-20T10:01:33+00:00"
}

Errors

An unknown work_item_key returns a validation error.
An empty or too-long body returns a validation error.
A caller without project_management::manage_work_items (or who fails the model policy) receives an authorization error.