@stubbedev/atlassian-mcp 0.1.14 → 0.1.15

package/README.md

@@ -53,7 +53,7 @@ A [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server for **s
 | `bitbucket_merge_pr` | Merge a pull request |
 | `bitbucket_decline_pr` | Decline a pull request |
 | `bitbucket_get_pr_comments` | Get PR comment threads in bulk, including task-style BLOCKER comments and blocker counts |
-| `bitbucket_add_pr_comment` | Add a top-level PR comment or reply to an existing comment |
+| `bitbucket_add_pr_comment` | Add a PR comment; when remarking on an existing comment, pass `commentId` so it is posted as a thread reply |
 | `bitbucket_update_pr_comment` | Update comment text/severity, resolve or reopen normal threads via `threadResolved`, and resolve/reopen BLOCKER tasks via `state` (strictly enforced) |
 | `bitbucket_delete_pr_comment` | Delete a PR comment by comment ID |
 | `bitbucket_get_pr_commits` | List commits included in a pull request |
@@ -78,6 +78,7 @@ All list tools support `limit` and `start`/`startAt` for pagination.
 - "update PR 42 title and reviewers" → `bitbucket_update_pull_request`
 - "create or update PR from this branch in one call" → `bitbucket_mutate_pull_request`
 - "show review comments on PR 42" → `bitbucket_get_pr_comments`
+- "reply to comment 123 on PR 42" → `bitbucket_add_pr_comment` with `commentId=123`
 - "give me one full overview of PR 42" → `bitbucket_get_pr_overview`
 - "how many open blockers are on PR 42" → `bitbucket_get_pr_comments` with `severity=BLOCKER` and `countOnly=true`
 - "resolve this review thread on PR 42" → `bitbucket_update_pr_comment` with `threadResolved=true`

package/dist/bitbucket.js

@@ -682,14 +682,25 @@ export class BitbucketClient {
     }
     async addPrComment(args) {
         const { projectKey, repoSlug } = this.resolveProjectAndRepo(args.projectKey, args.repoSlug);
+        const replyToCommentId = args.commentId;
+        if (replyToCommentId !== undefined
+            && (args.filePath !== undefined
+                || args.srcPath !== undefined
+                || args.line !== undefined
+                || args.lineType !== undefined
+                || args.fileType !== undefined
+                || args.multilineStartLine !== undefined
+                || args.multilineStartLineType !== undefined)) {
+            throw new Error('Replies must target an existing comment thread only. Omit filePath/line and other anchor fields when replying.');
+        }
         let commentText = args.text;
         if (args.suggestion !== undefined) {
             const suggestionBlock = `\`\`\`suggestion\n${args.suggestion}\n\`\`\``;
             commentText = args.text ? `${args.text}\n\n${suggestionBlock}` : suggestionBlock;
         }
         const body = { text: validateCommentText(commentText) };
-        if (args.parentCommentId)
-            body.parent = { id: args.parentCommentId };
+        if (replyToCommentId !== undefined)
+            body.parent = { id: replyToCommentId };
         let inlineAnchor;
         if (args.filePath !== undefined || args.line !== undefined) {
             if (args.filePath === undefined || args.line === undefined) {
@@ -733,8 +744,8 @@ export class BitbucketClient {
         }
         if (!created)
             return text(`Comment added to PR #${args.prId}.`);
-        if (args.parentCommentId) {
-            return text(`Reply #${created.id} added to comment #${args.parentCommentId} on PR #${args.prId}.`);
+        if (replyToCommentId !== undefined) {
+            return text(`Reply #${created.id} added to comment #${replyToCommentId} on PR #${args.prId}.`);
         }
         const location = args.filePath && args.line ? ` on ${args.filePath}:${args.line}` : '';
         return text(`Comment #${created.id} added to PR #${args.prId}${location}.`);

package/dist/index.js

@@ -548,7 +548,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
         },
         {
             name: 'bitbucket_get_pr_comments',
-            description: 'Use when you want PR review discussion in bulk: comment threads, task-style BLOCKER comments, and blocker counts with pagination. For review tasks, locate PR by branch first instead of assuming it is in your inbox. You can pass projectKey/repoSlug or project/repo.',
+            description: 'Use when you want PR review discussion in bulk: comment threads, task-style BLOCKER comments, and blocker counts with pagination. The returned comment IDs are used as commentId in bitbucket_add_pr_comment (reply mode), bitbucket_update_pr_comment, and bitbucket_delete_pr_comment. For review tasks, locate PR by branch first instead of assuming it is in your inbox. You can pass projectKey/repoSlug or project/repo.',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -571,6 +571,8 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
             name: 'bitbucket_add_pr_comment',
             description: `Add a PR review comment or reply to an existing thread.
 
+REPLIES TO SPECIFIC COMMENTS ARE MANDATORY: If your remark is about an existing comment/thread, you MUST reply in that thread by setting commentId. Do not post a new top-level PR comment or a new inline thread for follow-up remarks on an existing comment.
+
 FOR REVIEW FEEDBACK, DEFAULT TO INLINE + EXAMPLE: Prefer anchored inline comments with a concrete code change example (suggestion) over top-level prose. Use top-level comments only for overall PR-wide feedback.
 
 INLINE COMMENTS ARE STRONGLY PREFERRED: Whenever your comment refers to a specific line or block of code, you MUST provide filePath and line to anchor it as an inline comment on the diff. General top-level comments (no filePath/line) should only be used for overall PR feedback that does not relate to any particular line.
@@ -586,7 +588,7 @@ Keep comments concise, plain text, and free of filler. Never include emojis. You
                     repoSlug: { type: 'string', description: 'Repository slug, e.g. "payments-service" (usually auto-detected)' },
                     repo: { type: 'string', description: 'Alias for repoSlug' },
                     prId: { type: 'number', description: 'Pull request number (PR ID)' },
-                    parentCommentId: { type: 'number', description: 'Parent comment ID for reply mode (optional)' },
+                    commentId: { type: 'number', description: 'Comment ID to reply to. Same identifier style as update/delete tools (optional).' },
                     text: { type: 'string', description: 'Concise comment text. No filler. Do not include emojis. If suggestion is also provided, this text appears above the suggestion block.' },
                     filePath: { type: 'string', description: 'Destination file path for inline comment, e.g. "src/index.ts". Must be provided together with line.' },
                     srcPath: { type: 'string', description: 'Source file path. Only needed when the file was renamed; otherwise omit (defaults to filePath).' },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stubbedev/atlassian-mcp",
-  "version": "0.1.14",
+  "version": "0.1.15",
   "description": "MCP server for self-hosted Jira and Bitbucket",
   "license": "MIT",
   "type": "module",