@stubbedev/atlassian-mcp 0.3.4 → 0.3.6

package/README.md

@@ -67,6 +67,8 @@ A [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server for **s
 - "list releases for PAY" → `jira_search` with `resource=versions`, `project=PAY`
 - "release version 12345" → `jira_version` with `action=release`, `id=12345`
 - "set fix version 9.1.0 on FOO-123" → `jira_mutate` with `update.fixVersion=9.1.0`
+- "create a task under epic FOO-100" → `jira_mutate` with `create.issueType=Task`, `create.parent=FOO-100` (auto-detects Epic and sets Epic Link)
+- "move FOO-123 under epic FOO-100" → `jira_mutate` with `update.epicLink=FOO-100`
 
 ---
 

package/dist/bitbucket.js

@@ -810,6 +810,15 @@ export class BitbucketClient {
         await this.request('DELETE', `${this.rp(projectKey, repoSlug)}/pull-requests/${args.prId}/approve`);
         return text(`Approval removed from PR #${args.prId}.\n${this.pullRequestUrl(projectKey, repoSlug, args.prId)}`);
     }
+    async needsWorkPr(args) {
+        const { projectKey, repoSlug } = this.resolveProjectAndRepo(args.projectKey, args.repoSlug);
+        const userSlug = await this.getCurrentUsername();
+        const data = await this.request('PUT', `${this.rp(projectKey, repoSlug)}/pull-requests/${args.prId}/participants/${encodeURIComponent(userSlug)}`, { user: { name: userSlug }, approved: false, status: 'NEEDS_WORK' });
+        const url = this.pullRequestUrl(projectKey, repoSlug, args.prId);
+        if (!data)
+            return text(`Marked PR #${args.prId} as Needs work.\n${url}`);
+        return text(`Marked PR #${args.prId} as Needs work as ${data.user.displayName}.\n${url}`);
+    }
     async declinePr(args) {
         const { projectKey, repoSlug } = this.resolveProjectAndRepo(args.projectKey, args.repoSlug);
         const pr = await this.request('GET', `${this.rp(projectKey, repoSlug)}/pull-requests/${args.prId}`);

package/dist/index.js

@@ -261,7 +261,8 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                                 priority: { type: 'string', description: 'Priority name (optional)' },
                                 labels: { type: 'array', items: { type: 'string' }, description: 'Labels to apply (optional)' },
                                 fixVersion: { type: 'string', description: 'Fix version name (optional)' },
-                                parent: { type: 'string', description: 'Parent issue key for subtasks (optional)' },
+                                parent: { type: 'string', description: 'Parent issue key. For Sub-task issue types this sets the Jira parent. If the key points to an Epic, the Epic Link custom field is set automatically instead (Jira Server epic membership).' },
+                                epicLink: { type: 'string', description: 'Epic issue key to attach the new issue to as an epic child (Jira Server Epic Link). Overrides parent if both are passed.' },
                             },
                             required: ['issueType', 'summary'],
                         },
@@ -274,6 +275,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                                 priority: { type: 'string', description: 'New priority name (optional)' },
                                 labels: { type: 'array', items: { type: 'string' }, description: 'Replace label set (pass [] to clear)' },
                                 fixVersion: { type: 'string', description: 'Fix version name, or empty string to clear (optional)' },
+                                epicLink: { type: 'string', description: 'Epic issue key to set as parent epic (Jira Server Epic Link), or empty string to clear.' },
                             },
                         },
                         sprintId: { type: 'number', description: 'Sprint ID to add the issue into (optional)' },
@@ -402,7 +404,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
             },
             {
                 name: 'bitbucket_mutate',
-                description: 'Use when asked to "open a PR for this branch", "create a pull request", "approve this PR", "merge it", "ship it", or "decline this PR". Auto-targets the open PR for the current branch when prId is omitted. Handles create, update, approve/unapprove, decline, and merge in one call.',
+                description: 'Use when asked to "open a PR for this branch", "create a pull request", "approve this PR", "request changes / mark needs work", "merge it", "ship it", or "decline this PR". Auto-targets the open PR for the current branch when prId is omitted. Handles create, update, approve/unapprove, needs_work, decline, and merge in one call. needs_work sets your reviewer status to "Needs work" (Bitbucket Server\'s changes-requested signal); revert with action=unapprove.',
                 inputSchema: {
                     type: 'object',
                     properties: {
@@ -411,7 +413,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                         repoSlug: { type: 'string', description: 'Repository slug (usually auto-detected)' },
                         repo: { type: 'string', description: 'Alias for repoSlug' },
                         prId: { type: 'number', description: 'Target PR number (optional, auto-resolved from branch)' },
-                        action: { type: 'string', enum: ['approve', 'unapprove', 'decline', 'merge'], description: 'Lifecycle action to perform (optional)' },
+                        action: { type: 'string', enum: ['approve', 'unapprove', 'needs_work', 'decline', 'merge'], description: 'Lifecycle action to perform (optional). needs_work = mark your reviewer status as "Needs work" (changes requested).' },
                         mergeStrategy: { type: 'string', enum: ['MERGE_COMMIT', 'SQUASH', 'FAST_FORWARD'], description: 'Merge strategy (action=merge only)' },
                         mergeMessage: { type: 'string', description: 'Custom merge commit message (action=merge only)' },
                         declineMessage: { type: 'string', description: 'Decline message (action=decline only)' },
@@ -847,6 +849,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     return await bitbucket.approvePr(a);
                 if (action === 'unapprove')
                     return await bitbucket.unapprovePr(a);
+                if (action === 'needs_work')
+                    return await bitbucket.needsWorkPr(a);
                 if (action === 'decline')
                     return await bitbucket.declinePr({ ...a, message: a.declineMessage });
                 if (action === 'merge')

package/dist/jira.js

@@ -97,6 +97,8 @@ export class JiraClient {
     currentUserCache;
     projectsCache;
     issueLinkingEnabled;
+    epicLinkFieldIdCache;
+    issueTypeCache = new Map();
     constructor(baseUrl, token) {
         this.baseUrl = baseUrl.replace(/\/$/, '');
         this.headers = {
@@ -128,7 +130,17 @@ export class JiraClient {
             const details = parseJiraErrorDetails(errText);
             throw new Error(formatJiraError(res.status, method, path, details));
         }
-        return res.status === 204 ? null : res.json();
+        if (res.status === 204)
+            return null;
+        const raw = await res.text();
+        if (!raw)
+            return null;
+        try {
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
     }
     async request(method, path, body) {
         return this.requestWithBase('/rest/api/2', method, path, body);
@@ -159,6 +171,24 @@ export class JiraClient {
         this.issueLinkingEnabled = config?.issueLinkingEnabled ?? false;
         return this.issueLinkingEnabled;
     }
+    async getEpicLinkFieldId() {
+        if (this.epicLinkFieldIdCache !== undefined)
+            return this.epicLinkFieldIdCache;
+        const fields = (await this.request('GET', '/field')) ?? [];
+        const match = fields.find((f) => f.schema?.custom === 'com.pyxis.greenhopper.jira:gh-epic-link');
+        this.epicLinkFieldIdCache = match?.id ?? null;
+        return this.epicLinkFieldIdCache;
+    }
+    async getIssueType(issueKey) {
+        const cached = this.issueTypeCache.get(issueKey);
+        if (cached)
+            return cached;
+        const data = await this.request('GET', `/issue/${encodeURIComponent(issueKey)}?fields=issuetype`);
+        const name = data?.fields?.issuetype?.name ?? null;
+        if (name)
+            this.issueTypeCache.set(issueKey, name);
+        return name;
+    }
     async assertOwnComment(comment) {
         const me = await this.getCurrentUser();
         const commentAuthorName = this.normalizeIdentity(comment.author.name);
@@ -200,8 +230,23 @@ export class JiraClient {
             fields.labels = args.labels;
         if (args.fixVersion)
             fields.fixVersions = [{ name: args.fixVersion }];
-        if (args.parent)
-            fields.parent = { key: args.parent };
+        let epicLinkTarget = args.epicLink?.trim() || undefined;
+        if (args.parent) {
+            const parentType = await this.getIssueType(args.parent);
+            if (parentType === 'Epic') {
+                epicLinkTarget = epicLinkTarget ?? args.parent;
+            }
+            else {
+                fields.parent = { key: args.parent };
+            }
+        }
+        if (epicLinkTarget) {
+            const epicFieldId = await this.getEpicLinkFieldId();
+            if (!epicFieldId) {
+                throw new Error('Epic Link custom field not found on this Jira instance. Set it manually in the Jira UI.');
+            }
+            fields[epicFieldId] = epicLinkTarget;
+        }
         return this.request('POST', '/issue', { fields });
     }
     async updateIssueFieldsInternal(args) {
@@ -218,6 +263,13 @@ export class JiraClient {
             fields.labels = args.labels;
         if (args.fixVersion !== undefined)
             fields.fixVersions = args.fixVersion ? [{ name: args.fixVersion }] : [];
+        if (args.epicLink !== undefined) {
+            const epicFieldId = await this.getEpicLinkFieldId();
+            if (!epicFieldId) {
+                throw new Error('Epic Link custom field not found on this Jira instance. Set it manually in the Jira UI.');
+            }
+            fields[epicFieldId] = args.epicLink ? args.epicLink : null;
+        }
         if (Object.keys(fields).length === 0)
             return false;
         await this.request('PUT', `/issue/${encodeURIComponent(args.issueKey)}`, { fields });
@@ -401,11 +453,16 @@ export class JiraClient {
         const includeSprint = args.includeSprint ?? true;
         const commentsMaxResults = args.commentsMaxResults ?? 10;
         const commentsStartAt = args.commentsStartAt ?? 0;
-        const fields = 'summary,description,status,assignee,priority,issuetype,labels,components,parent,fixVersions,issuelinks,subtasks,attachment';
+        const baseFields = 'summary,description,status,assignee,priority,issuetype,labels,components,parent,fixVersions,issuelinks,subtasks,attachment';
+        const epicFieldId = await this.getEpicLinkFieldId();
+        const fields = epicFieldId ? `${baseFields},${epicFieldId}` : baseFields;
         const issue = await this.request('GET', `/issue/${encodeURIComponent(args.issueKey)}?fields=${fields}`);
         if (!issue)
             return text('Issue not found.');
         const f = issue.fields;
+        const epicLinkKey = epicFieldId && typeof f[epicFieldId] === 'string'
+            ? f[epicFieldId]
+            : undefined;
         const lines = [
             `Issue: ${issue.key} — ${f.summary}`,
             `URL:        ${this.issueUrl(issue.key)}`,
@@ -416,6 +473,7 @@ export class JiraClient {
             `Labels:     ${f.labels?.join(', ') || 'None'}`,
             `Components: ${f.components?.map((c) => c.name).join(', ') || 'None'}`,
             ...(f.parent ? [`Parent:     [${f.parent.key}] ${f.parent.fields.summary} (${f.parent.fields.issuetype.name})`] : []),
+            ...(epicLinkKey ? [`Epic Link:  ${epicLinkKey}`] : []),
             ...(f.fixVersions?.length ? [`Fix Vers:   ${f.fixVersions.map((v) => v.name).join(', ')}`] : []),
             ...(f.subtasks?.length ? [`Subtasks:   ${f.subtasks.map((s) => `[${s.key}] ${s.fields.summary} (${s.fields.status.name})`).join(', ')}`] : []),
             ...(f.issuelinks?.length ? [

package/package.json

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