---
name: tracker/jira-official:comment-add
description: Add comment to JIRA issue
version: "0.5.0"
---

# Comment Add

> **Backend:** jira-official (atlassian@claude-plugins-official)

> **Note:** Requires `atlassian@claude-plugins-official` plugin. Install: `/plugin install atlassian@claude-plugins-official`

Posts a new comment on the specified JIRA issue.

## Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| issue_key | string | Yes | JIRA issue key (e.g., `<PROJECT_KEY>-123`) |
| body | string | Yes | Comment text (plain text or Atlassian Document Format) |

## Implementation

Uses MCP JIRA tool: `mcp__atlassian__addCommentToJiraIssue`

```
mcp__atlassian__addCommentToJiraIssue({
  issue_key: "<issue_key>",
  body: "<body>"
})
```

## Output

| Field | Type | Description |
|-------|------|-------------|
| id | string | Comment ID assigned by JIRA |
| body | string | The comment text as stored |
| author | object | Author account ID and display name |
| created | string | ISO 8601 timestamp of comment creation |

## Errors

| Code | Cause | Recovery |
|------|-------|----------|
| 404 | Issue key not found | Verify the issue key exists and the project key is correct |
| 403 | Insufficient permissions to comment | Confirm the JIRA user has comment permissions on the project |
| 400 | Empty or malformed comment body | Ensure `body` is a non-empty string |
| MCP | Plugin unavailable | Verify the `atlassian@claude-plugins-official` plugin is installed and connected |

## Used By

- dev-task (posting progress updates or blockers on task issues)
- validate-ci (posting CI failure summaries to the relevant issue)
