@stubbedev/atlassian-mcp 0.3.3 → 0.3.5

package/README.md

@@ -27,11 +27,12 @@ A [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server for **s
 
 | Tool | Description |
 |---|---|
-| `jira_search` | Discover resources: `issues`, `projects`, `issue_types`, `boards`, `sprints`, `board_overview`, or `users` via `resource` param |
+| `jira_search` | Discover resources: `issues`, `projects`, `issue_types`, `boards`, `sprints`, `board_overview`, `versions`, or `users` via `resource` param |
 | `jira_get` | Full details for one issue: summary, description, status, sprint, transitions, comments, and attachment list |
 | `jira_get_attachment` | Fetch a Jira attachment by ID; images are auto-resized via sharp and returned inline so the model can see them, text/JSON inline, larger/binary files via `saveTo` |
 | `jira_mutate` | Create, update, transition, comment, link, add to sprint, or log work — all in one call |
 | `jira_comment` | Add, update, or delete a comment on an issue (`action`: `add` / `update` / `delete`) |
+| `jira_version` | Manage fix versions/releases (`action`: `create` / `update` / `release` / `archive` / `delete`) |
 
 ### Bitbucket
 
@@ -62,6 +63,10 @@ A [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server for **s
 - "what's in the current sprint?" → `jira_search` with `resource=board_overview`
 - "move FOO-123 to In Progress" → `jira_mutate` with `transitionName="In Progress"`
 - "log 2h on FOO-123" → `jira_mutate` with `worklog`
+- "create version 9.1.0 in PAY" → `jira_version` with `action=create`, `projectKey=PAY`, `name=9.1.0`
+- "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`
 
 ---
 

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

@@ -206,11 +206,11 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
             },
             {
                 name: 'jira_search',
-                description: 'Discover Jira resources. Use when asked "find tickets for...", "what\'s in the backlog", "show me my issues", "list projects", or "which board is for project X". Set resource:\n• "issues" (default) — search by text, JQL, project, status, assignee, issue type, or mine=true for your queue\n• "projects" — list all projects and their keys\n• "issue_types" — valid types and statuses for a project\n• "boards" — list boards (pass project to filter by project key); use this to find the boardId before fetching sprints or board_overview\n• "sprints" — sprints for a board (pass boardId); if you don\'t know the boardId, first use resource=boards\n• "board_overview" — active/future sprints with their issues for a board (pass boardId); use when asked "what\'s in the sprint", "show me the board", or "what\'s everyone working on"\n• "users" — find users by name/email (pass query)',
+                description: 'Discover Jira resources. Use when asked "find tickets for...", "what\'s in the backlog", "show me my issues", "list projects", or "which board is for project X". Set resource:\n• "issues" (default) — search by text, JQL, project, status, assignee, issue type, or mine=true for your queue\n• "projects" — list all projects and their keys\n• "issue_types" — valid types and statuses for a project\n• "boards" — list boards (pass project to filter by project key); use this to find the boardId before fetching sprints or board_overview\n• "sprints" — sprints for a board (pass boardId); if you don\'t know the boardId, first use resource=boards\n• "board_overview" — active/future sprints with their issues for a board (pass boardId); use when asked "what\'s in the sprint", "show me the board", or "what\'s everyone working on"\n• "versions" — list fix versions/releases for a project (pass project); use this to find the exact version name or id before setting fixVersion or releasing a version\n• "users" — find users by name/email (pass query)',
                 inputSchema: {
                     type: 'object',
                     properties: {
-                        resource: { type: 'string', enum: ['issues', 'projects', 'issue_types', 'boards', 'sprints', 'board_overview', 'users'], description: 'What to search (default: issues)' },
+                        resource: { type: 'string', enum: ['issues', 'projects', 'issue_types', 'boards', 'sprints', 'board_overview', 'versions', 'users'], description: 'What to search (default: issues)' },
                         mine: { type: 'boolean', description: 'Return issues assigned to you (resource=issues only)' },
                         query: { type: 'string', description: 'Text search or user name query' },
                         jql: { type: 'string', description: 'Raw JQL (resource=issues only, overrides other filters)' },
@@ -331,6 +331,25 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                     },
                     required: ['issueKey'],
                 },
+            },
+            {
+                name: 'jira_version',
+                description: 'Manage Jira fix versions (releases). Use when asked to "create version 9.1.0", "release version X", "archive version X", "rename a version", or "delete a version". action defaults to "create". For create pass projectKey + name. For update/release/archive/delete pass id (look it up via jira_search resource=versions). "release" sets released=true and defaults releaseDate to today. Once a version exists you can set it on tickets via jira_mutate update.fixVersion.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        action: { type: 'string', enum: ['create', 'update', 'release', 'archive', 'delete'], description: 'Operation (default: create)' },
+                        projectKey: { type: 'string', description: 'Jira project code (required for create when not auto-resolvable)' },
+                        project: { type: 'string', description: 'Alias for projectKey' },
+                        id: { type: 'string', description: 'Version id (required for update/release/archive/delete; look up via jira_search resource=versions)' },
+                        name: { type: 'string', description: 'Version name, e.g. "9.1.0" (required for create; optional rename for update)' },
+                        description: { type: 'string', description: 'Version description (optional)' },
+                        startDate: { type: 'string', description: 'Start date in YYYY-MM-DD (optional)' },
+                        releaseDate: { type: 'string', description: 'Release date in YYYY-MM-DD (optional; defaults to today on action=release)' },
+                        released: { type: 'boolean', description: 'Released flag (optional; action=release forces true)' },
+                        archived: { type: 'boolean', description: 'Archived flag (optional; action=archive forces true)' },
+                    },
+                },
             }
         ] : []),
         ...(bitbucket ? [{
@@ -383,7 +402,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: {
@@ -392,7 +411,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)' },
@@ -758,6 +777,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     return await jira.getSprints({ boardId: a.boardId, state: a.sprintState, maxResults: a.maxResults, startAt: a.startAt });
                 if (resource === 'board_overview')
                     return await jira.boardOverview({ boardId: a.boardId, sprintState: a.sprintState, sprintMaxResults: a.maxResults, sprintStartAt: a.startAt, includeIssues: a.includeIssues, assignee: a.assignee, status: a.status });
+                if (resource === 'versions')
+                    return await jira.listVersions({ projectKey: a.projectKey ?? a.project, maxResults: a.maxResults });
                 if (resource === 'users')
                     return await jira.searchUsers({ query: a.query ?? '', maxResults: a.maxResults });
                 // issues (default)
@@ -790,6 +811,12 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     return await jira.deleteComment({ issueKey: a.issueKey, commentId: a.commentId });
                 return await jira.addComment({ issueKey: a.issueKey, body: a.body });
             }
+            case 'jira_version': {
+                if (!jira)
+                    throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
+                const a = normalizeJiraProjectArgs(args);
+                return await jira.mutateVersion(a);
+            }
             // Bitbucket
             case 'bitbucket_search': {
                 if (!bitbucket)
@@ -820,6 +847,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

@@ -761,4 +761,96 @@ export class JiraClient {
         await this.transitionIssueInternal(args.issueKey, transitionId);
         return text(`Transitioned ${args.issueKey} using transition ${transitionId}.\n${this.issueUrl(args.issueKey)}`);
     }
+    async listVersions(args) {
+        const projectKey = await this.resolveProjectKey(args.projectKey);
+        const data = await this.request('GET', `/project/${encodeURIComponent(projectKey)}/versions`);
+        if (!data || data.length === 0)
+            return text(`No versions in ${projectKey}.`);
+        const sorted = [...data].sort((a, b) => {
+            if (a.released !== b.released)
+                return a.released ? 1 : -1;
+            if (a.archived !== b.archived)
+                return a.archived ? 1 : -1;
+            const ad = a.releaseDate ?? '';
+            const bd = b.releaseDate ?? '';
+            return bd.localeCompare(ad);
+        });
+        const limit = args.maxResults ?? sorted.length;
+        const shown = sorted.slice(0, limit);
+        const lines = shown.map((v, i) => {
+            const tags = [];
+            if (v.released)
+                tags.push('released');
+            if (v.archived)
+                tags.push('archived');
+            const tagStr = tags.length ? ` [${tags.join(', ')}]` : '';
+            const dateParts = [v.startDate ? `start ${v.startDate}` : '', v.releaseDate ? `release ${v.releaseDate}` : ''].filter(Boolean);
+            const dateStr = dateParts.length ? ` (${dateParts.join(', ')})` : '';
+            return `${i + 1}. [${v.id}] ${v.name}${tagStr}${dateStr}`;
+        });
+        const more = data.length > shown.length ? `\n...and ${data.length - shown.length} more (raise maxResults).` : '';
+        return text(`${data.length} version(s) in ${projectKey}:\n${lines.join('\n')}${more}`);
+    }
+    async mutateVersion(args) {
+        const action = args.action ?? 'create';
+        if (action === 'create') {
+            const projectKey = await this.resolveProjectKey(args.projectKey);
+            const name = args.name?.trim();
+            if (!name)
+                throw new Error('name is required to create a version.');
+            const body = { project: projectKey, name };
+            if (args.description !== undefined)
+                body.description = args.description;
+            if (args.releaseDate)
+                body.releaseDate = args.releaseDate;
+            if (args.startDate)
+                body.startDate = args.startDate;
+            if (args.released !== undefined)
+                body.released = args.released;
+            if (args.archived !== undefined)
+                body.archived = args.archived;
+            const created = await this.request('POST', '/version', body);
+            if (!created)
+                throw new Error('Jira returned no body when creating version.');
+            return text(`Created version [${created.id}] ${created.name} in ${projectKey}.`);
+        }
+        const id = args.id?.trim();
+        if (!id)
+            throw new Error(`version id is required for action=${action}.`);
+        if (action === 'delete') {
+            await this.request('DELETE', `/version/${encodeURIComponent(id)}`);
+            return text(`Deleted version ${id}.`);
+        }
+        const body = {};
+        if (args.name !== undefined)
+            body.name = args.name;
+        if (args.description !== undefined)
+            body.description = args.description;
+        if (args.startDate !== undefined)
+            body.startDate = args.startDate;
+        if (args.releaseDate !== undefined)
+            body.releaseDate = args.releaseDate;
+        if (args.released !== undefined)
+            body.released = args.released;
+        if (args.archived !== undefined)
+            body.archived = args.archived;
+        if (action === 'release') {
+            body.released = true;
+            if (body.releaseDate === undefined)
+                body.releaseDate = new Date().toISOString().slice(0, 10);
+        }
+        else if (action === 'archive') {
+            body.archived = true;
+        }
+        if (Object.keys(body).length === 0) {
+            throw new Error('Nothing to update.');
+        }
+        const updated = await this.request('PUT', `/version/${encodeURIComponent(id)}`, body);
+        const label = updated ? `[${updated.id}] ${updated.name}` : id;
+        if (action === 'release')
+            return text(`Released version ${label} on ${body.releaseDate}.`);
+        if (action === 'archive')
+            return text(`Archived version ${label}.`);
+        return text(`Updated version ${label}.`);
+    }
 }

package/package.json

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