@stubbedev/atlassian-mcp 0.4.0 → 0.4.1

package/dist/index.js

@@ -232,7 +232,7 @@ 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• "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)',
+                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; optionally pass query to filter by name substring). If the version you need does not exist, create it yourself with `jira_version action=create` — do NOT ask the user to make it in the Jira UI.\n• "users" — find users by name/email (pass query)',
                 inputSchema: {
                     type: 'object',
                     properties: {
@@ -816,7 +816,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 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 });
+                    return await jira.listVersions({ projectKey: a.projectKey ?? a.project, query: a.query, maxResults: a.maxResults });
                 if (resource === 'users')
                     return await jira.searchUsers({ query: a.query ?? '', maxResults: a.maxResults });
                 // issues (default)

package/dist/jira.js

@@ -864,9 +864,20 @@ export class JiraClient {
     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)
+        const query = args.query?.trim();
+        const createHint = (name) => `Create it with: jira_version action=create projectKey=${projectKey} name="${name}"`;
+        if (!data || data.length === 0) {
+            if (query)
+                return text(`No versions in ${projectKey}. ${createHint(query)}`);
             return text(`No versions in ${projectKey}.`);
-        const sorted = [...data].sort((a, b) => {
+        }
+        const filtered = query
+            ? data.filter(v => v.name.toLowerCase().includes(query.toLowerCase()))
+            : data;
+        if (query && filtered.length === 0) {
+            return text(`No version matching "${query}" in ${projectKey} (${data.length} other version(s) exist). ${createHint(query)}`);
+        }
+        const sorted = [...filtered].sort((a, b) => {
             if (a.released !== b.released)
                 return a.released ? 1 : -1;
             if (a.archived !== b.archived)
@@ -888,8 +899,11 @@ export class JiraClient {
             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}`);
+        const header = query
+            ? `${filtered.length} version(s) matching "${query}" in ${projectKey}:`
+            : `${filtered.length} version(s) in ${projectKey}:`;
+        const more = filtered.length > shown.length ? `\n...and ${filtered.length - shown.length} more (raise maxResults).` : '';
+        return text(`${header}\n${lines.join('\n')}${more}`);
     }
     async mutateVersion(args) {
         const action = args.action ?? 'create';

package/package.json

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