@stubbedev/atlassian-mcp 0.1.7 → 0.1.9

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 stubbedev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -45,7 +45,9 @@ A [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server for **s
 | `bitbucket_get_pull_request` | Get pull request details |
 | `bitbucket_get_pr_overview` | Get a one-call PR overview: metadata, commits, comments, task-style BLOCKER comments, and optional diff |
 | `bitbucket_get_pr_diff` | Get the code diff for a pull request |
-| `bitbucket_create_pull_request` | Create a new pull request |
+| `bitbucket_create_pull_request` | Create a new pull request (checks for an existing open PR from the source branch first) |
+| `bitbucket_update_pull_request` | Update pull request title, description, destination branch, or reviewers |
+| `bitbucket_mutate_pull_request` | Create or update a pull request in one call (target by PR ID or source branch) |
 | `bitbucket_approve_pr` | Approve a pull request |
 | `bitbucket_unapprove_pr` | Remove your approval from a pull request |
 | `bitbucket_merge_pr` | Merge a pull request |
@@ -73,6 +75,8 @@ All list tools support `limit` and `start`/`startAt` for pagination.
 - "show my PRs waiting for review" → `bitbucket_my_prs`
 - "list open PRs for this repo from branch feature/ABC-123" → `bitbucket_list_pull_requests`
 - "open a PR from my current branch to master" → `bitbucket_create_pull_request`
+- "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`
 - "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`
@@ -113,7 +117,7 @@ The `$schema` field is optional but enables editor autocomplete and validation.
   - Jira: `project` (alias of `projectKey`)
   - Bitbucket: `project` and `repo` (aliases of `projectKey` and `repoSlug`)
 - For Bitbucket tools, `projectKey` and `repoSlug` are usually auto-detected from your local `origin` remote.
-- `bitbucket_create_pull_request` also auto-detects `fromBranch` from your current branch.
+- `bitbucket_create_pull_request` also auto-detects `fromBranch` from your current branch and returns the existing open PR if one already exists for that branch.
 - Jira project-scoped calls accept `projectKey` and work best when provided.
 - If `projectKey` is omitted for Jira issue creation/type lookup, the server tries to infer it from your current branch ticket key, falls back to auto-select when only one project is visible, and otherwise returns a numbered project list to pick from.
 

package/dist/bitbucket.js

@@ -31,6 +31,9 @@ function text(t) {
 function toBranchRef(branch) {
     return branch.startsWith('refs/') ? branch : `refs/heads/${branch}`;
 }
+function branchDisplayId(branch) {
+    return branch.replace(/^refs\/heads\//, '');
+}
 function formatDate(ms) {
     return new Date(ms).toISOString().slice(0, 10);
 }
@@ -236,8 +239,17 @@ export class BitbucketClient {
     }
     // Used internally by context tools — finds the open PR for a given source branch
     async findOpenPrForBranch(projectKey, repoSlug, branch) {
-        const data = await this.request('GET', `/projects/${projectKey}/repos/${repoSlug}/pull-requests?state=OPEN&limit=50`);
-        return data?.values.find((pr) => pr.fromRef.displayId === branch) ?? null;
+        const targetBranch = branchDisplayId(branch);
+        let start = 0;
+        while (true) {
+            const data = await this.request('GET', `/projects/${projectKey}/repos/${repoSlug}/pull-requests?state=OPEN&limit=50&start=${start}`);
+            const match = data?.values.find((pr) => branchDisplayId(pr.fromRef.displayId) === targetBranch) ?? null;
+            if (match)
+                return match;
+            if (!data || data.isLastPage || data.nextPageStart === undefined)
+                return null;
+            start = data.nextPageStart;
+        }
     }
     async listRepos(args) {
         const { limit = 50, start = 0 } = args;
@@ -399,6 +411,12 @@ export class BitbucketClient {
         if (!sourceBranch || sourceBranch === 'HEAD') {
             throw new Error('Could not determine source branch. Provide fromBranch or run from a checked-out branch.');
         }
+        const sourceBranchName = branchDisplayId(sourceBranch);
+        const existing = await this.findOpenPrForBranch(projectKey, repoSlug, sourceBranchName);
+        if (existing) {
+            const url = this.pullRequestUrl(projectKey, repoSlug, existing.id, existing);
+            return text(`Open PR already exists for branch "${sourceBranchName}": #${existing.id} "${existing.title}"\n${url}`);
+        }
         const { title, description, toBranch = 'master', reviewers = [] } = args;
         const body = {
             title,
@@ -413,6 +431,109 @@ export class BitbucketClient {
         const url = this.pullRequestUrl(projectKey, repoSlug, data.id, data);
         return text(`Created PR #${data.id}: "${data.title}"\n${url}`);
     }
+    async updatePullRequest(args) {
+        const { projectKey, repoSlug } = this.resolveProjectAndRepo(args.projectKey, args.repoSlug);
+        if (args.title === undefined
+            && args.description === undefined
+            && args.toBranch === undefined
+            && args.reviewers === undefined) {
+            throw new Error('At least one field is required: title, description, toBranch, or reviewers');
+        }
+        const existing = await this.request('GET', `/projects/${projectKey}/repos/${repoSlug}/pull-requests/${args.prId}`);
+        if (!existing)
+            throw new Error(`PR #${args.prId} not found.`);
+        const buildBody = (version) => {
+            const body = { version };
+            if (args.title !== undefined)
+                body.title = args.title;
+            if (args.description !== undefined)
+                body.description = args.description;
+            if (args.toBranch !== undefined) {
+                body.toRef = {
+                    id: toBranchRef(args.toBranch),
+                    repository: { slug: repoSlug, project: { key: projectKey } },
+                };
+            }
+            if (args.reviewers !== undefined) {
+                body.reviewers = args.reviewers.map((name) => ({ user: { name } }));
+            }
+            return body;
+        };
+        let updated;
+        try {
+            updated = await this.request('PUT', `/projects/${projectKey}/repos/${repoSlug}/pull-requests/${args.prId}`, buildBody(existing.version));
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            if (!message.includes('Bitbucket 409'))
+                throw error;
+            const latest = await this.request('GET', `/projects/${projectKey}/repos/${repoSlug}/pull-requests/${args.prId}`);
+            if (!latest)
+                throw error;
+            updated = await this.request('PUT', `/projects/${projectKey}/repos/${repoSlug}/pull-requests/${args.prId}`, buildBody(latest.version));
+        }
+        if (!updated)
+            return text(`Updated PR #${args.prId}.`);
+        const url = this.pullRequestUrl(projectKey, repoSlug, updated.id, updated);
+        return text(`Updated PR #${updated.id}: "${updated.title}" (${updated.fromRef.displayId} → ${updated.toRef.displayId}).\n${url}`);
+    }
+    async mutatePullRequest(args) {
+        const { projectKey, repoSlug } = this.resolveProjectAndRepo(args.projectKey, args.repoSlug);
+        const hasUpdate = args.update !== undefined && (args.update.title !== undefined
+            || args.update.description !== undefined
+            || args.update.toBranch !== undefined
+            || args.update.reviewers !== undefined);
+        if (args.prId !== undefined) {
+            if (!hasUpdate) {
+                return this.getPullRequest({ projectKey, repoSlug, prId: args.prId });
+            }
+            return this.updatePullRequest({
+                projectKey,
+                repoSlug,
+                prId: args.prId,
+                ...args.update,
+            });
+        }
+        const sourceBranch = args.create?.fromBranch ?? safeExec('git rev-parse --abbrev-ref HEAD');
+        if (!sourceBranch || sourceBranch === 'HEAD') {
+            if (args.create) {
+                return this.createPullRequest({
+                    projectKey,
+                    repoSlug,
+                    title: args.create.title,
+                    description: args.create.description,
+                    fromBranch: args.create.fromBranch,
+                    toBranch: args.create.toBranch,
+                    reviewers: args.create.reviewers,
+                });
+            }
+            throw new Error('Could not determine source branch. Provide create.fromBranch or run from a checked-out branch.');
+        }
+        const existing = await this.findOpenPrForBranch(projectKey, repoSlug, sourceBranch);
+        if (existing) {
+            if (hasUpdate) {
+                return this.updatePullRequest({
+                    projectKey,
+                    repoSlug,
+                    prId: existing.id,
+                    ...args.update,
+                });
+            }
+            return this.getPullRequest({ projectKey, repoSlug, prId: existing.id });
+        }
+        if (!args.create) {
+            throw new Error(`No open PR found for branch "${branchDisplayId(sourceBranch)}". Provide create to open one.`);
+        }
+        return this.createPullRequest({
+            projectKey,
+            repoSlug,
+            title: args.create.title,
+            description: args.create.description,
+            fromBranch: args.create.fromBranch,
+            toBranch: args.create.toBranch,
+            reviewers: args.create.reviewers,
+        });
+    }
     async approvePr(args) {
         const { projectKey, repoSlug } = this.resolveProjectAndRepo(args.projectKey, args.repoSlug);
         const data = await this.request('POST', `/projects/${projectKey}/repos/${repoSlug}/pull-requests/${args.prId}/approve`);

package/dist/index.js

@@ -413,7 +413,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
         },
         {
             name: 'bitbucket_create_pull_request',
-            description: 'Use when you want to open a new PR. Project/repo auto-detect from git remote, source branch auto-detects from current branch if omitted, and you can pass projectKey/repoSlug or project/repo.',
+            description: 'Use when you want to open a new PR. Project/repo auto-detect from git remote, source branch auto-detects from current branch if omitted, and this call first checks for an existing open PR from that source branch.',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -430,6 +430,59 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                 required: ['title'],
             },
         },
+        {
+            name: 'bitbucket_update_pull_request',
+            description: 'Use when you want to update an existing PR title, description, destination branch, or reviewers. You can pass projectKey/repoSlug or project/repo.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    projectKey: { type: 'string', description: 'Bitbucket project code, e.g. "ENG" (usually auto-detected)' },
+                    project: { type: 'string', description: 'Alias for projectKey' },
+                    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)' },
+                    title: { type: 'string', description: 'Updated PR title (optional)' },
+                    description: { type: 'string', description: 'Updated PR description, or empty string to clear (optional)' },
+                    toBranch: { type: 'string', description: 'Updated target branch name (optional)' },
+                    reviewers: { type: 'array', items: { type: 'string' }, description: 'Updated reviewer usernames (optional). Pass an empty array to clear reviewers.' },
+                },
+                required: ['prId'],
+            },
+        },
+        {
+            name: 'bitbucket_mutate_pull_request',
+            description: 'Use when you want one ergonomic PR mutation call: target a PR by prId, or auto-target the open PR from create.fromBranch/current branch, then optionally update it; if none exists and create is provided, create a new PR.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    projectKey: { type: 'string', description: 'Bitbucket project code, e.g. "ENG" (usually auto-detected)' },
+                    project: { type: 'string', description: 'Alias for projectKey' },
+                    repoSlug: { type: 'string', description: 'Repository slug, e.g. "payments-service" (usually auto-detected)' },
+                    repo: { type: 'string', description: 'Alias for repoSlug' },
+                    prId: { type: 'number', description: 'Target pull request number (optional). If omitted, tool targets the open PR for create.fromBranch/current branch.' },
+                    create: {
+                        type: 'object',
+                        properties: {
+                            title: { type: 'string', description: 'PR title' },
+                            description: { type: 'string', description: 'PR description (optional)' },
+                            fromBranch: { type: 'string', description: 'Source branch to target/create from (defaults to current branch)' },
+                            toBranch: { type: 'string', description: 'Destination branch (default: master when creating)' },
+                            reviewers: { type: 'array', items: { type: 'string' }, description: 'Reviewer usernames (optional)' },
+                        },
+                        required: ['title'],
+                    },
+                    update: {
+                        type: 'object',
+                        properties: {
+                            title: { type: 'string', description: 'Updated PR title (optional)' },
+                            description: { type: 'string', description: 'Updated PR description, or empty string to clear (optional)' },
+                            toBranch: { type: 'string', description: 'Updated target branch (optional)' },
+                            reviewers: { type: 'array', items: { type: 'string' }, description: 'Updated reviewer usernames (optional). Pass an empty array to clear reviewers.' },
+                        },
+                    },
+                },
+            },
+        },
         {
             name: 'bitbucket_approve_pr',
             description: 'Use when you want to approve a PR. You can pass projectKey/repoSlug or project/repo.',
@@ -694,6 +747,10 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 return await bitbucket.getPrCommits(normalizeBitbucketArgs(args));
             case 'bitbucket_create_pull_request':
                 return await bitbucket.createPullRequest(normalizeBitbucketArgs(args));
+            case 'bitbucket_update_pull_request':
+                return await bitbucket.updatePullRequest(normalizeBitbucketArgs(args));
+            case 'bitbucket_mutate_pull_request':
+                return await bitbucket.mutatePullRequest(normalizeBitbucketArgs(args));
             case 'bitbucket_approve_pr':
                 return await bitbucket.approvePr(normalizeBitbucketArgs(args));
             case 'bitbucket_unapprove_pr':

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@stubbedev/atlassian-mcp",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "MCP server for self-hosted Jira and Bitbucket",
+  "license": "MIT",
   "type": "module",
   "main": "dist/index.js",
   "files": [