@rui.branco/jira-mcp 1.6.9 → 1.6.11

package/index.js

@@ -1256,6 +1256,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
               description:
                 "Fetch linked Figma designs and export images (default: true)",
             },
+            instance: {
+              type: "string",
+              description: "Instance name override. Auto-detected from issue key prefix if omitted.",
+            },
           },
           required: ["issueKey"],
         },
@@ -1298,6 +1302,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
               description: "The Jira issue key (e.g., MODS-123)",
             },
             comment: { type: "string", description: "The comment text to add" },
+            instance: {
+              type: "string",
+              description: "Instance name override. Auto-detected from issue key prefix if omitted.",
+            },
           },
           required: ["issueKey", "comment"],
         },
@@ -1319,6 +1327,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                 "The ID of the comment to reply to. Use jira_get_ticket to see comments and their IDs.",
             },
             reply: { type: "string", description: "The reply text" },
+            instance: {
+              type: "string",
+              description: "Instance name override. Auto-detected from issue key prefix if omitted.",
+            },
           },
           required: ["issueKey", "commentId", "reply"],
         },
@@ -1340,6 +1352,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                 "The ID of the comment to edit. Use jira_get_ticket to see comments and their IDs.",
             },
             comment: { type: "string", description: "The new comment text" },
+            instance: {
+              type: "string",
+              description: "Instance name override. Auto-detected from issue key prefix if omitted.",
+            },
           },
           required: ["issueKey", "commentId", "comment"],
         },
@@ -1360,6 +1376,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
               description:
                 "The ID of the comment to delete. Use jira_get_ticket to see comments and their IDs.",
             },
+            instance: {
+              type: "string",
+              description: "Instance name override. Auto-detected from issue key prefix if omitted.",
+            },
           },
           required: ["issueKey", "commentId"],
         },
@@ -1385,6 +1405,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
               description:
                 "Target status name (e.g., 'Review', 'Done'). Will auto-transition through intermediate states if needed.",
             },
+            instance: {
+              type: "string",
+              description: "Instance name override. Auto-detected from issue key prefix if omitted.",
+            },
           },
           required: ["issueKey"],
         },
@@ -1438,6 +1462,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
               items: { type: "string" },
               description: "Labels to set on the ticket",
             },
+            instance: {
+              type: "string",
+              description: "Instance name override. Auto-detected from issue key prefix if omitted.",
+            },
           },
           required: ["issueKey"],
         },
@@ -1499,7 +1527,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       {
         name: "jira_add_instance",
         description:
-          "Add or update a Jira instance configuration. Saves to config and makes it available immediately without restart. Use this to connect to a new Jira instance during a session.",
+          "Add or update a Jira instance configuration. Saves to config and makes it available immediately without restart. To add a new instance, provide name + email + token + baseUrl. To update an existing instance (e.g. change projects or set as default), just provide name and the fields to change.",
         inputSchema: {
           type: "object",
           properties: {
@@ -1509,27 +1537,27 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
             },
             email: {
               type: "string",
-              description: "Jira account email",
+              description: "Jira account email (required for new instances)",
             },
             token: {
               type: "string",
-              description: "Jira API token (from https://id.atlassian.com/manage-profile/security/api-tokens)",
+              description: "Jira API token (required for new instances)",
             },
             baseUrl: {
               type: "string",
-              description: "Jira base URL (e.g., https://company.atlassian.net)",
+              description: "Jira base URL (required for new instances, e.g., https://company.atlassian.net)",
             },
             projects: {
               type: "array",
               items: { type: "string" },
-              description: "Project key prefixes to auto-route to this instance (e.g., ['PROJ', 'ENG'])",
+              description: "Project key prefixes to auto-route to this instance (e.g., ['PROJ', 'ENG']). Replaces existing projects.",
             },
             setDefault: {
               type: "boolean",
               description: "Set this instance as the default (default: false)",
             },
           },
-          required: ["name", "email", "token", "baseUrl"],
+          required: ["name"],
         },
       },
       {
@@ -1609,7 +1637,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
     } else if (name === "jira_get_ticket") {
       const downloadImages = args.downloadImages !== false;
       const fetchFigma = args.fetchFigma !== false;
-      const result = await getTicket(args.issueKey, downloadImages, fetchFigma);
+      const inst = args.instance ? getInstanceByName(args.instance) : null;
+      const result = await getTicket(args.issueKey, downloadImages, fetchFigma, inst);
 
       const content = [{ type: "text", text: result.text }];
 
@@ -1657,7 +1686,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       const result = await searchTickets(args.jql, args.maxResults || 10, args.fields || null, inst);
       return { content: [{ type: "text", text: result }] };
     } else if (name === "jira_add_comment") {
-      const inst = getInstanceForKey(args.issueKey);
+      const inst = args.instance ? getInstanceByName(args.instance) : getInstanceForKey(args.issueKey);
       // Build ADF content with mention support
       const adfContent = await buildCommentADF(args.comment, inst);
       const body = {
@@ -1682,7 +1711,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         ],
       };
     } else if (name === "jira_reply_comment") {
-      const inst = getInstanceForKey(args.issueKey);
+      const inst = args.instance ? getInstanceByName(args.instance) : getInstanceForKey(args.issueKey);
       // Fetch the original comment
       const original = await fetchJira(
         `/issue/${args.issueKey}/comment/${args.commentId}`,
@@ -1750,7 +1779,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         ],
       };
     } else if (name === "jira_edit_comment") {
-      const inst = getInstanceForKey(args.issueKey);
+      const inst = args.instance ? getInstanceByName(args.instance) : getInstanceForKey(args.issueKey);
       // Build ADF content with mention support
       const adfContent = await buildCommentADF(args.comment, inst);
       const body = {
@@ -1774,7 +1803,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         ],
       };
     } else if (name === "jira_delete_comment") {
-      const inst = getInstanceForKey(args.issueKey);
+      const inst = args.instance ? getInstanceByName(args.instance) : getInstanceForKey(args.issueKey);
       await fetchJira(`/issue/${args.issueKey}/comment/${args.commentId}`, {
         method: "DELETE",
       }, inst);
@@ -1787,7 +1816,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         ],
       };
     } else if (name === "jira_transition") {
-      const inst = getInstanceForKey(args.issueKey);
+      const inst = args.instance ? getInstanceByName(args.instance) : getInstanceForKey(args.issueKey);
       if (!args.transitionId && !args.targetStatus) {
         // List available transitions
         const result = await fetchJira(`/issue/${args.issueKey}/transitions`, {}, inst);
@@ -1883,7 +1912,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         ],
       };
     } else if (name === "jira_update_ticket") {
-      const inst = getInstanceForKey(args.issueKey);
+      const inst = args.instance ? getInstanceByName(args.instance) : getInstanceForKey(args.issueKey);
       const fields = {};
       if (args.summary) {
         if (args.replaceSummary) {
@@ -2006,31 +2035,34 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       }
     } else if (name === "jira_add_instance") {
       const instName = args.name.trim();
-      const projects = (args.projects || []).map((p) => p.toUpperCase());
-      const authStr = Buffer.from(`${args.email}:${args.token}`).toString("base64");
-      const newInstance = {
-        name: instName,
-        email: args.email,
-        token: args.token,
-        baseUrl: args.baseUrl.replace(/\/$/, ""),
-        projects,
-        auth: authStr,
-      };
+      const existingIdx = instances.findIndex((i) => i.name === instName);
+      const isUpdate = existingIdx >= 0;
+
+      // For new instances, email/token/baseUrl are required
+      if (!isUpdate && (!args.email || !args.token || !args.baseUrl)) {
+        return {
+          content: [{ type: "text", text: "New instance requires email, token, and baseUrl." }],
+          isError: true,
+        };
+      }
+
+      // Merge with existing or create new
+      const existing = isUpdate ? instances[existingIdx] : {};
+      const email = args.email || existing.email;
+      const token = args.token || existing.token;
+      const baseUrl = args.baseUrl ? args.baseUrl.replace(/\/$/, "") : existing.baseUrl;
+      const projects = args.projects ? args.projects.map((p) => p.toUpperCase()) : (existing.projects || []);
+      const authStr = Buffer.from(`${email}:${token}`).toString("base64");
+
+      const newInstance = { name: instName, email, token, baseUrl, projects, auth: authStr };
 
       // Update in-memory instances
-      const existingIdx = instances.findIndex((i) => i.name === instName);
-      if (existingIdx >= 0) {
+      if (isUpdate) {
         instances[existingIdx] = newInstance;
       } else {
         instances.push(newInstance);
       }
 
-      // Update default if requested or if it's the first instance
-      if (args.setDefault || instances.length === 1) {
-        // Can't reassign const, but defaultInstance is used via getInstanceByName/getInstanceForKey
-        // which search the instances array, so this is handled by rawConfig.defaultInstance below
-      }
-
       // Persist to config file
       const savedConfig = loadConfigFile();
       if (!savedConfig.instances) {
@@ -2053,7 +2085,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       }
 
       // Save without the computed auth field
-      const toSave = { name: instName, email: args.email, token: args.token, baseUrl: newInstance.baseUrl, projects };
+      const toSave = { name: instName, email, token, baseUrl, projects };
       const savedIdx = savedConfig.instances.findIndex((i) => i.name === instName);
       if (savedIdx >= 0) {
         savedConfig.instances[savedIdx] = toSave;
@@ -2065,8 +2097,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       }
       fs.writeFileSync(jiraConfigPath, JSON.stringify(savedConfig, null, 2));
 
-      const action = existingIdx >= 0 ? "Updated" : "Added";
-      let text = `${action} instance "${instName}" (${newInstance.baseUrl}).`;
+      const action = isUpdate ? "Updated" : "Added";
+      let text = `${action} instance "${instName}" (${baseUrl}).`;
       if (projects.length > 0) text += ` Projects: ${projects.join(", ")}.`;
       if (args.setDefault) text += " Set as default.";
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rui.branco/jira-mcp",
-  "version": "1.6.9",
+  "version": "1.6.11",
   "description": "Jira MCP server for Claude Code - fetch tickets, search with JQL, update tickets, manage comments, change status, and get Figma designs",
   "main": "index.js",
   "bin": {