@stubbedev/atlassian-mcp 0.1.5 → 0.1.6

package/dist/bitbucket.js

@@ -158,6 +158,13 @@ export class BitbucketClient {
             Accept: 'application/json',
         };
     }
+    pullRequestUrl(projectKey, repoSlug, prId, pr) {
+        const apiUrl = pr?.links?.self?.[0]?.href?.trim();
+        if (apiUrl) {
+            return apiUrl;
+        }
+        return `${this.baseUrl}/projects/${encodeURIComponent(projectKey)}/repos/${encodeURIComponent(repoSlug)}/pull-requests/${prId}`;
+    }
     resolveProjectAndRepo(projectKey, repoSlug) {
         if (projectKey && repoSlug)
             return { projectKey, repoSlug };
@@ -375,20 +382,21 @@ export class BitbucketClient {
         const data = await this.request('POST', `/projects/${projectKey}/repos/${repoSlug}/pull-requests`, body);
         if (!data)
             return text('Pull request created.');
-        const url = data.links?.self?.[0]?.href ?? '';
-        return text(`Created PR #${data.id}: "${data.title}"${url ? `\n${url}` : ''}`);
+        const url = this.pullRequestUrl(projectKey, repoSlug, data.id, data);
+        return text(`Created PR #${data.id}: "${data.title}"\n${url}`);
     }
     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`);
+        const url = this.pullRequestUrl(projectKey, repoSlug, args.prId);
         if (!data)
-            return text(`Approved PR #${args.prId}.`);
-        return text(`Approved PR #${args.prId} as ${data.user.displayName}.`);
+            return text(`Approved PR #${args.prId}.\n${url}`);
+        return text(`Approved PR #${args.prId} as ${data.user.displayName}.\n${url}`);
     }
     async unapprovePr(args) {
         const { projectKey, repoSlug } = this.resolveProjectAndRepo(args.projectKey, args.repoSlug);
         await this.request('DELETE', `/projects/${projectKey}/repos/${repoSlug}/pull-requests/${args.prId}/approve`);
-        return text(`Approval removed from PR #${args.prId}.`);
+        return text(`Approval removed from PR #${args.prId}.\n${this.pullRequestUrl(projectKey, repoSlug, args.prId)}`);
     }
     async declinePr(args) {
         const { projectKey, repoSlug } = this.resolveProjectAndRepo(args.projectKey, args.repoSlug);
@@ -400,8 +408,8 @@ export class BitbucketClient {
             body.message = args.message;
         const data = await this.request('POST', `/projects/${projectKey}/repos/${repoSlug}/pull-requests/${args.prId}/decline`, body);
         if (!data)
-            return text(`Declined PR #${args.prId}.`);
-        return text(`Declined PR #${data.id}: "${data.title}".`);
+            return text(`Declined PR #${args.prId}.\n${this.pullRequestUrl(projectKey, repoSlug, args.prId)}`);
+        return text(`Declined PR #${data.id}: "${data.title}".\n${this.pullRequestUrl(projectKey, repoSlug, data.id, data)}`);
     }
     async mergePr(args) {
         const { projectKey, repoSlug } = this.resolveProjectAndRepo(args.projectKey, args.repoSlug);
@@ -415,8 +423,8 @@ export class BitbucketClient {
             body.message = args.message;
         const data = await this.request('POST', `/projects/${projectKey}/repos/${repoSlug}/pull-requests/${args.prId}/merge`, body);
         if (!data)
-            return text(`Merged PR #${args.prId}.`);
-        return text(`Merged PR #${data.id}: "${data.title}" (${data.fromRef.displayId} → ${data.toRef.displayId}).`);
+            return text(`Merged PR #${args.prId}.\n${this.pullRequestUrl(projectKey, repoSlug, args.prId)}`);
+        return text(`Merged PR #${data.id}: "${data.title}" (${data.fromRef.displayId} → ${data.toRef.displayId}).\n${this.pullRequestUrl(projectKey, repoSlug, data.id, data)}`);
     }
     async getBranches(args) {
         const { projectKey, repoSlug } = this.resolveProjectAndRepo(args.projectKey, args.repoSlug);

package/dist/jira.js

@@ -98,6 +98,18 @@ export class JiraClient {
             Accept: 'application/json',
         };
     }
+    issueUrl(issueKey) {
+        return `${this.baseUrl}/browse/${encodeURIComponent(issueKey)}`;
+    }
+    projectUrl(projectKey) {
+        return `${this.baseUrl}/projects/${encodeURIComponent(projectKey)}`;
+    }
+    boardUrl(boardId) {
+        return `${this.baseUrl}/secure/RapidBoard.jspa?rapidView=${boardId}`;
+    }
+    sprintUrl(boardId, sprintId) {
+        return `${this.boardUrl(boardId)}&sprint=${sprintId}`;
+    }
     async requestWithBase(apiBase, method, path, body) {
         const url = `${this.baseUrl}${apiBase}${path}`;
         const opts = { method, headers: this.headers };
@@ -208,7 +220,7 @@ export class JiraClient {
             return text('No results.');
         const lines = data.issues.map((i, idx) => {
             const assignee = i.fields.assignee?.displayName ?? 'Unassigned';
-            return `${startAt + idx + 1}. [${i.key}] ${i.fields.summary} | ${i.fields.status.name} | ${assignee}`;
+            return `${startAt + idx + 1}. [${i.key}] ${i.fields.summary} | ${i.fields.status.name} | ${assignee} | ${this.issueUrl(i.key)}`;
         });
         const page = pagination(data.total, startAt, data.issues.length);
         return text(`Found ${data.total} issues${page}:\n${lines.join('\n')}`);
@@ -225,7 +237,7 @@ export class JiraClient {
         const data = await this.request('GET', `/project?maxResults=${limit}`);
         if (!data || data.length === 0)
             return text('No projects found.');
-        const lines = data.map((p, i) => `${i + 1}. [${p.key}] ${p.name} (${p.projectTypeKey})`);
+        const lines = data.map((p, i) => `${i + 1}. [${p.key}] ${p.name} (${p.projectTypeKey}) | ${this.projectUrl(p.key)}`);
         return text(`${data.length} project(s):\n${lines.join('\n')}`);
     }
     async getIssueTypes(args) {
@@ -253,11 +265,11 @@ export class JiraClient {
         const lines = data.values.map((s, i) => {
             const window = [s.startDate?.slice(0, 10), s.endDate?.slice(0, 10)].filter(Boolean).join(' -> ');
             const goal = s.goal?.trim() ? ` | Goal: ${s.goal}` : '';
-            return `${startAt + i + 1}. [${s.id}] ${s.name} | ${s.state}${window ? ` | ${window}` : ''}${goal}`;
+            return `${startAt + i + 1}. [${s.id}] ${s.name} | ${s.state}${window ? ` | ${window}` : ''}${goal} | ${this.sprintUrl(boardId, s.id)}`;
         });
         const rangeEnd = startAt + data.values.length;
         const page = data.isLast ? '' : ` (showing ${startAt + 1}-${rangeEnd}, use startAt=${rangeEnd} for next page)`;
-        return text(`Sprints for board ${boardId}${page}:\n${lines.join('\n')}`);
+        return text(`Sprints for board ${boardId}${page}:\nBoard URL: ${this.boardUrl(boardId)}\n${lines.join('\n')}`);
     }
     async searchUsers(args) {
         const params = new URLSearchParams({
@@ -305,6 +317,7 @@ export class JiraClient {
         const f = issue.fields;
         const lines = [
             `Issue: ${issue.key} — ${f.summary}`,
+            `URL:        ${this.issueUrl(issue.key)}`,
             `Status:     ${f.status.name}`,
             `Type:       ${f.issuetype.name}`,
             `Priority:   ${f.priority?.name ?? 'None'}`,
@@ -400,12 +413,13 @@ export class JiraClient {
         const issueBySprint = new Map(sprintIssueData.map((entry) => [entry.sprintId, entry.issues]));
         const lines = [
             `Board: [${args.boardId}] ${board?.name ?? '(unknown)'} | ${board?.type ?? '(unknown type)'}`,
+            `URL: ${this.boardUrl(args.boardId)}`,
             `Sprints: ${sprints.values.length}`,
             '',
         ];
         sprints.values.forEach((sprint, idx) => {
             const window = [sprint.startDate?.slice(0, 10), sprint.endDate?.slice(0, 10)].filter(Boolean).join(' -> ');
-            lines.push(`${sprintStartAt + idx + 1}. [${sprint.id}] ${sprint.name} | ${sprint.state}${window ? ` | ${window}` : ''}`);
+            lines.push(`${sprintStartAt + idx + 1}. [${sprint.id}] ${sprint.name} | ${sprint.state}${window ? ` | ${window}` : ''} | ${this.sprintUrl(args.boardId, sprint.id)}`);
             if (sprint.goal?.trim()) {
                 lines.push(`   Goal: ${sprint.goal}`);
             }
@@ -415,7 +429,7 @@ export class JiraClient {
                 lines.push(`   Issues: ${issueData?.total ?? 0}`);
                 for (const issue of issues) {
                     const assignee = issue.fields.assignee?.displayName ?? 'Unassigned';
-                    lines.push(`   - [${issue.key}] ${issue.fields.summary} | ${issue.fields.status.name} | ${assignee}`);
+                    lines.push(`   - [${issue.key}] ${issue.fields.summary} | ${issue.fields.status.name} | ${assignee} | ${this.issueUrl(issue.key)}`);
                 }
                 if ((issueData?.total ?? 0) > issues.length) {
                     lines.push(`   ...and ${(issueData?.total ?? 0) - issues.length} more (adjust issueStartAt/issueMaxResults).`);
@@ -433,11 +447,12 @@ export class JiraClient {
         const data = await this.createIssueInternal(args);
         if (!data)
             return text('Issue created.');
+        const url = this.issueUrl(data.key);
         if (args.sprintId !== undefined) {
             await this.addIssuesToSprintInternal(args.sprintId, [data.key]);
-            return text(`Created ${data.key} and added it to sprint ${args.sprintId}.`);
+            return text(`Created ${data.key} and added it to sprint ${args.sprintId}.\n${url}`);
         }
-        return text(`Created ${data.key}.`);
+        return text(`Created ${data.key}.\n${url}`);
     }
     async updateIssue(args) {
         const hasFieldUpdates = await this.updateIssueFieldsInternal(args);
@@ -447,12 +462,12 @@ export class JiraClient {
             await this.addIssuesToSprintInternal(args.sprintId, [args.issueKey]);
         }
         if (hasFieldUpdates && args.sprintId !== undefined) {
-            return text(`Updated ${args.issueKey} and added it to sprint ${args.sprintId}.`);
+            return text(`Updated ${args.issueKey} and added it to sprint ${args.sprintId}.\n${this.issueUrl(args.issueKey)}`);
         }
         if (hasFieldUpdates) {
-            return text(`Updated ${args.issueKey}.`);
+            return text(`Updated ${args.issueKey}.\n${this.issueUrl(args.issueKey)}`);
         }
-        return text(`Added ${args.issueKey} to sprint ${args.sprintId}.`);
+        return text(`Added ${args.issueKey} to sprint ${args.sprintId}.\n${this.issueUrl(args.issueKey)}`);
     }
     async addIssuesToSprint(args) {
         const keys = new Set();
@@ -468,7 +483,14 @@ export class JiraClient {
         }
         const issueKeys = Array.from(keys);
         await this.addIssuesToSprintInternal(args.sprintId, issueKeys);
-        return text(`Added ${issueKeys.length} issue(s) to sprint ${args.sprintId}.`);
+        if (issueKeys.length === 1) {
+            return text(`Added ${issueKeys[0]} to sprint ${args.sprintId}.\n${this.issueUrl(issueKeys[0])}`);
+        }
+        const lines = [
+            `Added ${issueKeys.length} issue(s) to sprint ${args.sprintId}.`,
+            ...issueKeys.map((issueKey) => `${issueKey}: ${this.issueUrl(issueKey)}`),
+        ];
+        return text(lines.join('\n'));
     }
     async mutateIssue(args) {
         let issueKey = args.issueKey?.trim();
@@ -504,7 +526,7 @@ export class JiraClient {
         if (actions.length === 0) {
             return text('Nothing to mutate.');
         }
-        return text(`Mutated ${issueKey}: ${actions.join(', ')}.`);
+        return text(`Mutated ${issueKey}: ${actions.join(', ')}.\n${this.issueUrl(issueKey)}`);
     }
     async getComments(args) {
         const { issueKey, maxResults = 50, startAt = 0 } = args;
@@ -525,6 +547,6 @@ export class JiraClient {
     async transitionIssue(args) {
         const transitionId = await this.resolveTransitionId(args.issueKey, args.transitionId, args.transitionName);
         await this.transitionIssueInternal(args.issueKey, transitionId);
-        return text(`Transitioned ${args.issueKey} using transition ${transitionId}.`);
+        return text(`Transitioned ${args.issueKey} using transition ${transitionId}.\n${this.issueUrl(args.issueKey)}`);
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stubbedev/atlassian-mcp",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "MCP server for self-hosted Jira and Bitbucket",
   "type": "module",
   "main": "dist/index.js",