@azure-devops/mcp 2.5.0-nightly.20260412 → 2.5.0-nightly.20260414

package/dist/tools/repositories.js

@@ -811,42 +811,76 @@ function configureRepoTools(server, tokenProvider, connectionProvider, userAgent
         project: z.string().optional().describe("Project ID or project name. Required when repositoryId is a repository name instead of a GUID."),
         includeWorkItemRefs: z.boolean().optional().default(false).describe("Whether to reference work items associated with the pull request."),
         includeLabels: z.boolean().optional().default(false).describe("Whether to include a summary of labels in the response."),
-    }, async ({ repositoryId, pullRequestId, project, includeWorkItemRefs, includeLabels }) => {
+        includeChangedFiles: z.boolean().optional().default(false).describe("Whether to include the list of files changed in the pull request."),
+    }, async ({ repositoryId, pullRequestId, project, includeWorkItemRefs, includeLabels, includeChangedFiles }) => {
         try {
             const connection = await connectionProvider();
             const gitApi = await connection.getGitApi();
             const pullRequest = await gitApi.getPullRequest(repositoryId, pullRequestId, project, undefined, undefined, undefined, undefined, includeWorkItemRefs);
+            let enhancedResponse = { ...pullRequest };
             if (includeLabels) {
                 try {
                     const projectId = pullRequest.repository?.project?.id;
                     const projectName = pullRequest.repository?.project?.name;
                     const labels = await gitApi.getPullRequestLabels(repositoryId, pullRequestId, projectName, projectId);
                     const labelNames = labels.map((label) => label.name).filter((name) => name !== undefined);
-                    const enhancedResponse = {
-                        ...pullRequest,
+                    enhancedResponse = {
+                        ...enhancedResponse,
                         labelSummary: {
                             labels: labelNames,
                             labelCount: labelNames.length,
                         },
                     };
-                    return {
-                        content: [{ type: "text", text: JSON.stringify(enhancedResponse, null, 2) }],
-                    };
                 }
                 catch (error) {
                     console.warn(`Error fetching PR labels: ${error instanceof Error ? error.message : "Unknown error"}`);
-                    // Fall back to the original response without labels
-                    const enhancedResponse = {
-                        ...pullRequest,
+                    enhancedResponse = {
+                        ...enhancedResponse,
                         labelSummary: {},
                     };
-                    return {
-                        content: [{ type: "text", text: JSON.stringify(enhancedResponse, null, 2) }],
+                }
+            }
+            if (includeChangedFiles) {
+                try {
+                    const iterations = await gitApi.getPullRequestIterations(repositoryId, pullRequestId, project);
+                    if (iterations?.length) {
+                        const latestIteration = iterations[iterations.length - 1];
+                        if (latestIteration.id != null) {
+                            const changes = await gitApi.getPullRequestIterationChanges(repositoryId, pullRequestId, latestIteration.id, project);
+                            enhancedResponse = {
+                                ...enhancedResponse,
+                                changedFilesSummary: {
+                                    changeEntries: changes?.changeEntries ?? [],
+                                    fileCount: changes?.changeEntries?.length ?? 0,
+                                    nextSkip: changes?.nextSkip,
+                                    nextTop: changes?.nextTop,
+                                },
+                            };
+                        }
+                        else {
+                            enhancedResponse = {
+                                ...enhancedResponse,
+                                changedFilesSummary: { changeEntries: [], fileCount: 0 },
+                            };
+                        }
+                    }
+                    else {
+                        enhancedResponse = {
+                            ...enhancedResponse,
+                            changedFilesSummary: { changeEntries: [], fileCount: 0 },
+                        };
+                    }
+                }
+                catch (error) {
+                    console.warn(`Error fetching PR changed files: ${error instanceof Error ? error.message : "Unknown error"}`);
+                    enhancedResponse = {
+                        ...enhancedResponse,
+                        changedFilesSummary: {},
                     };
                 }
             }
             return {
-                content: [{ type: "text", text: JSON.stringify(pullRequest, null, 2) }],
+                content: [{ type: "text", text: JSON.stringify(enhancedResponse, null, 2) }],
             };
         }
         catch (error) {

package/dist/tools/search.js

@@ -12,7 +12,10 @@ const SEARCH_TOOLS = {
 function configureSearchTools(server, tokenProvider, connectionProvider, userAgentProvider) {
     server.tool(SEARCH_TOOLS.search_code, "Search Azure DevOps Repositories for a given search text", {
         searchText: z.string().describe("Keywords to search for in code repositories"),
-        project: z.array(z.string()).optional().describe("Filter by projects"),
+        project: z
+            .union([z.string().transform((value) => [value]), z.array(z.string())])
+            .optional()
+            .describe("Filter by projects"),
         repository: z.array(z.string()).optional().describe("Filter by repositories"),
         path: z.array(z.string()).optional().describe("Filter by paths"),
         branch: z.array(z.string()).optional().describe("Filter by branches"),

package/dist/tools/work-items.js

@@ -4,7 +4,7 @@ import { WorkItemExpand } from "azure-devops-node-api/interfaces/WorkItemTrackin
 import { QueryExpand } from "azure-devops-node-api/interfaces/WorkItemTrackingInterfaces.js";
 import { z } from "zod";
 import { batchApiVersion, markdownCommentsApiVersion, getEnumKeys, safeEnumConvert, encodeFormattedValue } from "../utils.js";
-import { elicitProject } from "../shared/elicitations.js";
+import { elicitProject, elicitTeam } from "../shared/elicitations.js";
 import { createExternalContentResponse } from "../shared/content-safety.js";
 const WORKITEM_TOOLS = {
     my_work_items: "wit_my_work_items",
@@ -62,14 +62,28 @@ function getLinkTypeFromName(name) {
     }
 }
 function configureWorkItemTools(server, tokenProvider, connectionProvider, userAgentProvider) {
-    server.tool(WORKITEM_TOOLS.list_backlogs, "Receive a list of backlogs for a given project and team.", {
-        project: z.string().describe("The name or ID of the Azure DevOps project."),
-        team: z.string().describe("The name or ID of the Azure DevOps team."),
+    server.tool(WORKITEM_TOOLS.list_backlogs, "Receive a list of backlogs for a given project and team. If a project or team is not specified, you will be prompted to select one.", {
+        project: z.string().optional().describe("The name or ID of the Azure DevOps project. Reuse from prior context if already known. If not provided, a project selection prompt will be shown."),
+        team: z.string().optional().describe("The name or ID of the Azure DevOps team. Reuse from prior context if already known. If not provided, a team selection prompt will be shown."),
     }, async ({ project, team }) => {
         try {
             const connection = await connectionProvider();
+            let resolvedProject = project;
+            if (!resolvedProject) {
+                const result = await elicitProject(server, connection, "Select the Azure DevOps project to list backlogs for.");
+                if ("response" in result)
+                    return result.response;
+                resolvedProject = result.resolved;
+            }
+            let resolvedTeam = team;
+            if (!resolvedTeam) {
+                const result = await elicitTeam(server, connection, resolvedProject, "Select the Azure DevOps team to list backlogs for.");
+                if ("response" in result)
+                    return result.response;
+                resolvedTeam = result.resolved;
+            }
             const workApi = await connection.getWorkApi();
-            const teamContext = { project, team };
+            const teamContext = { project: resolvedProject, team: resolvedTeam };
             const backlogs = await workApi.getBacklogs(teamContext);
             return {
                 content: [{ type: "text", text: JSON.stringify(backlogs, null, 2) }],
@@ -83,15 +97,29 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider, userA
             };
         }
     });
-    server.tool(WORKITEM_TOOLS.list_backlog_work_items, "Retrieve a list of backlogs of for a given project, team, and backlog category", {
-        project: z.string().describe("The name or ID of the Azure DevOps project."),
-        team: z.string().describe("The name or ID of the Azure DevOps team."),
+    server.tool(WORKITEM_TOOLS.list_backlog_work_items, "Retrieve a list of backlogs of for a given project, team, and backlog category. If a project or team is not specified, you will be prompted to select one.", {
+        project: z.string().optional().describe("The name or ID of the Azure DevOps project. Reuse from prior context if already known. If not provided, a project selection prompt will be shown."),
+        team: z.string().optional().describe("The name or ID of the Azure DevOps team. Reuse from prior context if already known. If not provided, a team selection prompt will be shown."),
         backlogId: z.string().describe("The ID of the backlog category to retrieve work items from."),
     }, async ({ project, team, backlogId }) => {
         try {
             const connection = await connectionProvider();
+            let resolvedProject = project;
+            if (!resolvedProject) {
+                const result = await elicitProject(server, connection, "Select the Azure DevOps project to list backlog work items for.");
+                if ("response" in result)
+                    return result.response;
+                resolvedProject = result.resolved;
+            }
+            let resolvedTeam = team;
+            if (!resolvedTeam) {
+                const result = await elicitTeam(server, connection, resolvedProject, "Select the Azure DevOps team to list backlog work items for.");
+                if ("response" in result)
+                    return result.response;
+                resolvedTeam = result.resolved;
+            }
             const workApi = await connection.getWorkApi();
-            const teamContext = { project, team };
+            const teamContext = { project: resolvedProject, team: resolvedTeam };
             const workItems = await workApi.getBacklogLevelWorkItems(teamContext, backlogId);
             return {
                 content: [{ type: "text", text: JSON.stringify(workItems, null, 2) }],
@@ -105,16 +133,23 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider, userA
             };
         }
     });
-    server.tool(WORKITEM_TOOLS.my_work_items, "Retrieve a list of work items relevent to the authenticated user.", {
-        project: z.string().describe("The name or ID of the Azure DevOps project."),
+    server.tool(WORKITEM_TOOLS.my_work_items, "Retrieve a list of work items relevent to the authenticated user. If a project is not specified, you will be prompted to select one.", {
+        project: z.string().optional().describe("The name or ID of the Azure DevOps project. Reuse from prior context if already known. If not provided, a project selection prompt will be shown."),
         type: z.enum(["assignedtome", "myactivity"]).default("assignedtome").describe("The type of work items to retrieve. Defaults to 'assignedtome'."),
         top: z.coerce.number().default(50).describe("The maximum number of work items to return. Defaults to 50."),
         includeCompleted: z.boolean().default(false).describe("Whether to include completed work items. Defaults to false."),
     }, async ({ project, type, top, includeCompleted }) => {
         try {
             const connection = await connectionProvider();
+            let resolvedProject = project;
+            if (!resolvedProject) {
+                const result = await elicitProject(server, connection, "Select the Azure DevOps project to retrieve work items for.");
+                if ("response" in result)
+                    return result.response;
+                resolvedProject = result.resolved;
+            }
             const workApi = await connection.getWorkApi();
-            const workItems = await workApi.getPredefinedQueryResults(project, type, top, includeCompleted);
+            const workItems = await workApi.getPredefinedQueryResults(resolvedProject, type, top, includeCompleted);
             return {
                 content: [{ type: "text", text: JSON.stringify(workItems, null, 2) }],
             };
@@ -127,18 +162,25 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider, userA
             };
         }
     });
-    server.tool(WORKITEM_TOOLS.get_work_items_batch_by_ids, "Retrieve list of work items by IDs in batch.", {
-        project: z.string().describe("The name or ID of the Azure DevOps project."),
+    server.tool(WORKITEM_TOOLS.get_work_items_batch_by_ids, "Retrieve list of work items by IDs in batch. If a project is not specified, you will be prompted to select one.", {
+        project: z.string().optional().describe("The name or ID of the Azure DevOps project. Reuse from prior context if already known. If not provided, a project selection prompt will be shown."),
         ids: z.array(z.coerce.number().min(1)).describe("The IDs of the work items to retrieve."),
         fields: z.array(z.string()).optional().describe("Optional list of fields to include in the response. If not provided, a hardcoded default set of fields will be used."),
     }, async ({ project, ids, fields }) => {
         try {
             const connection = await connectionProvider();
+            let resolvedProject = project;
+            if (!resolvedProject) {
+                const result = await elicitProject(server, connection, "Select the Azure DevOps project to retrieve work items for.");
+                if ("response" in result)
+                    return result.response;
+                resolvedProject = result.resolved;
+            }
             const workItemApi = await connection.getWorkItemTrackingApi();
             const defaultFields = ["System.Id", "System.WorkItemType", "System.Title", "System.State", "System.Parent", "System.Tags", "Microsoft.VSTS.Common.StackRank", "System.AssignedTo"];
             // If no fields are provided, use the default set of fields
             const fieldsToUse = !fields || fields.length === 0 ? defaultFields : fields;
-            const workitems = await workItemApi.getWorkItemsBatch({ ids, fields: fieldsToUse }, project);
+            const workitems = await workItemApi.getWorkItemsBatch({ ids, fields: fieldsToUse }, resolvedProject);
             // List of identity fields that need to be transformed from objects to formatted strings
             const identityFields = [
                 "System.AssignedTo",
@@ -177,21 +219,36 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider, userA
             };
         }
     });
-    server.tool(WORKITEM_TOOLS.get_work_item, "Get a single work item by ID.", {
+    server.tool(WORKITEM_TOOLS.get_work_item, "Get a single work item by ID. If a project is not specified, you will be prompted to select one.", {
         id: z.coerce.number().min(1).describe("The ID of the work item to retrieve."),
-        project: z.string().describe("The name or ID of the Azure DevOps project."),
-        fields: z.array(z.string()).optional().describe("Optional list of fields to include in the response. If not provided, all fields will be returned."),
+        project: z.string().optional().describe("The name or ID of the Azure DevOps project. Reuse from prior context if already known. If not provided, a project selection prompt will be shown."),
+        fields: z
+            .array(z.string())
+            .optional()
+            .describe("Optional list of fields to include in the response. If not provided, all fields will be returned. Cannot be used together with the expand parameter."),
         asOf: z.coerce.date().optional().describe("Optional date string to retrieve the work item as of a specific time. If not provided, the current state will be returned."),
         expand: z
             .enum(["all", "fields", "links", "none", "relations"])
-            .describe("Optional expand parameter to include additional details in the response.")
+            .describe("Optional expand parameter to include additional details in the response. Cannot be used together with the fields parameter.")
             .optional()
-            .describe("Expand options include 'all', 'fields', 'links', 'none', and 'relations'. Relations can be used to get child workitems. Defaults to 'none'."),
+            .describe("Expand options include 'All', 'Fields', 'Links', 'None', and 'Relations'. Relations can be used to get child workitems. Defaults to 'None'. Cannot be used together with the fields parameter."),
     }, async ({ id, project, fields, asOf, expand }) => {
         try {
             const connection = await connectionProvider();
+            let resolvedProject = project;
+            if (!resolvedProject) {
+                const result = await elicitProject(server, connection, "Select the Azure DevOps project to retrieve the work item from.");
+                if ("response" in result)
+                    return result.response;
+                resolvedProject = result.resolved;
+            }
+            // The Azure DevOps API does not support using expand and fields together.
+            // When both are provided, prefer fields as it is the more specific selection.
+            if (fields && fields.length > 0 && expand != null) {
+                expand = "none";
+            }
             const workItemApi = await connection.getWorkItemTrackingApi();
-            const workItem = await workItemApi.getWorkItem(id, fields, asOf, expand, project);
+            const workItem = await workItemApi.getWorkItem(id, fields, asOf, expand, resolvedProject);
             return {
                 content: [{ type: "text", text: JSON.stringify(workItem, null, 2) }],
             };
@@ -204,15 +261,22 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider, userA
             };
         }
     });
-    server.tool(WORKITEM_TOOLS.list_work_item_comments, "Retrieve list of comments for a work item by ID.", {
-        project: z.string().describe("The name or ID of the Azure DevOps project."),
+    server.tool(WORKITEM_TOOLS.list_work_item_comments, "Retrieve list of comments for a work item by ID. If a project is not specified, you will be prompted to select one.", {
+        project: z.string().optional().describe("The name or ID of the Azure DevOps project. Reuse from prior context if already known. If not provided, a project selection prompt will be shown."),
         workItemId: z.coerce.number().min(1).describe("The ID of the work item to retrieve comments for."),
         top: z.coerce.number().default(50).describe("Optional number of comments to retrieve. Defaults to all comments."),
     }, async ({ project, workItemId, top }) => {
         try {
             const connection = await connectionProvider();
+            let resolvedProject = project;
+            if (!resolvedProject) {
+                const result = await elicitProject(server, connection, "Select the Azure DevOps project to list work item comments for.");
+                if ("response" in result)
+                    return result.response;
+                resolvedProject = result.resolved;
+            }
             const workItemApi = await connection.getWorkItemTrackingApi();
-            const comments = await workItemApi.getComments(project, workItemId, top);
+            const comments = await workItemApi.getComments(resolvedProject, workItemId, top);
             return {
                 content: [{ type: "text", text: JSON.stringify(comments, null, 2) }],
             };
@@ -225,21 +289,28 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider, userA
             };
         }
     });
-    server.tool(WORKITEM_TOOLS.add_work_item_comment, "Add comment to a work item by ID.", {
-        project: z.string().describe("The name or ID of the Azure DevOps project."),
+    server.tool(WORKITEM_TOOLS.add_work_item_comment, "Add comment to a work item by ID. If a project is not specified, you will be prompted to select one.", {
+        project: z.string().optional().describe("The name or ID of the Azure DevOps project. Reuse from prior context if already known. If not provided, a project selection prompt will be shown."),
         workItemId: z.coerce.number().min(1).describe("The ID of the work item to add a comment to."),
         comment: z.string().describe("The text of the comment to add to the work item."),
         format: z.enum(["markdown", "html"]).optional().default("html"),
     }, async ({ project, workItemId, comment, format }) => {
         try {
             const connection = await connectionProvider();
+            let resolvedProject = project;
+            if (!resolvedProject) {
+                const result = await elicitProject(server, connection, "Select the Azure DevOps project to add a work item comment in.");
+                if ("response" in result)
+                    return result.response;
+                resolvedProject = result.resolved;
+            }
             const orgUrl = connection.serverUrl;
             const accessToken = await tokenProvider();
             const body = {
                 text: comment,
             };
             const formatParameter = format === "markdown" ? 0 : 1;
-            const response = await fetch(`${orgUrl}/${encodeURIComponent(project)}/_apis/wit/workItems/${workItemId}/comments?format=${formatParameter}&api-version=${markdownCommentsApiVersion}`, {
+            const response = await fetch(`${orgUrl}/${encodeURIComponent(resolvedProject)}/_apis/wit/workItems/${workItemId}/comments?format=${formatParameter}&api-version=${markdownCommentsApiVersion}`, {
                 method: "POST",
                 headers: {
                     "Authorization": `Bearer ${accessToken}`,
@@ -264,8 +335,8 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider, userA
             };
         }
     });
-    server.tool(WORKITEM_TOOLS.update_work_item_comment, "Update an existing comment on a work item by ID.", {
-        project: z.string().describe("The name or ID of the Azure DevOps project."),
+    server.tool(WORKITEM_TOOLS.update_work_item_comment, "Update an existing comment on a work item by ID. If a project is not specified, you will be prompted to select one.", {
+        project: z.string().optional().describe("The name or ID of the Azure DevOps project. Reuse from prior context if already known. If not provided, a project selection prompt will be shown."),
         workItemId: z.coerce.number().min(1).describe("The ID of the work item."),
         commentId: z.coerce.number().min(1).describe("The ID of the comment to update."),
         text: z.string().describe("The updated comment text."),
@@ -273,11 +344,18 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider, userA
     }, async ({ project, workItemId, commentId, text, format }) => {
         try {
             const connection = await connectionProvider();
+            let resolvedProject = project;
+            if (!resolvedProject) {
+                const result = await elicitProject(server, connection, "Select the Azure DevOps project to update the work item comment in.");
+                if ("response" in result)
+                    return result.response;
+                resolvedProject = result.resolved;
+            }
             const orgUrl = connection.serverUrl;
             const accessToken = await tokenProvider();
             const body = { text };
             const formatParameter = format === "markdown" ? 0 : 1;
-            const response = await fetch(`${orgUrl}/${encodeURIComponent(project)}/_apis/wit/workItems/${workItemId}/comments/${commentId}?format=${formatParameter}&api-version=${markdownCommentsApiVersion}`, {
+            const response = await fetch(`${orgUrl}/${encodeURIComponent(resolvedProject)}/_apis/wit/workItems/${workItemId}/comments/${commentId}?format=${formatParameter}&api-version=${markdownCommentsApiVersion}`, {
                 method: "PATCH",
                 headers: {
                     "Authorization": `Bearer ${accessToken}`,
@@ -302,8 +380,8 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider, userA
             };
         }
     });
-    server.tool(WORKITEM_TOOLS.list_work_item_revisions, "Retrieve list of revisions for a work item by ID.", {
-        project: z.string().describe("The name or ID of the Azure DevOps project."),
+    server.tool(WORKITEM_TOOLS.list_work_item_revisions, "Retrieve list of revisions for a work item by ID. If a project is not specified, you will be prompted to select one.", {
+        project: z.string().optional().describe("The name or ID of the Azure DevOps project. Reuse from prior context if already known. If not provided, a project selection prompt will be shown."),
         workItemId: z.coerce.number().min(1).describe("The ID of the work item to retrieve revisions for."),
         top: z.coerce.number().default(50).describe("Optional number of revisions to retrieve. If not provided, all revisions will be returned."),
         skip: z.coerce.number().optional().describe("Optional number of revisions to skip for pagination. Defaults to 0."),
@@ -315,8 +393,15 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider, userA
     }, async ({ project, workItemId, top, skip, expand }) => {
         try {
             const connection = await connectionProvider();
+            let resolvedProject = project;
+            if (!resolvedProject) {
+                const result = await elicitProject(server, connection, "Select the Azure DevOps project to list work item revisions for.");
+                if ("response" in result)
+                    return result.response;
+                resolvedProject = result.resolved;
+            }
             const workItemApi = await connection.getWorkItemTrackingApi();
-            const revisions = await workItemApi.getRevisions(workItemId, top, skip, safeEnumConvert(WorkItemExpand, expand), project);
+            const revisions = await workItemApi.getRevisions(workItemId, top, skip, safeEnumConvert(WorkItemExpand, expand), resolvedProject);
             // Dynamically clean up identity objects in revision fields
             // Identity objects typically have properties like displayName, url, _links, id, uniqueName, imageUrl, descriptor
             if (revisions && Array.isArray(revisions)) {
@@ -354,9 +439,9 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider, userA
             };
         }
     });
-    server.tool(WORKITEM_TOOLS.add_child_work_items, "Create one or many child work items from a parent by work item type and parent id.", {
+    server.tool(WORKITEM_TOOLS.add_child_work_items, "Create one or many child work items from a parent by work item type and parent id. If a project is not specified, you will be prompted to select one.", {
         parentId: z.coerce.number().min(1).describe("The ID of the parent work item to create a child work item under."),
-        project: z.string().describe("The name or ID of the Azure DevOps project."),
+        project: z.string().optional().describe("The name or ID of the Azure DevOps project. Reuse from prior context if already known. If not provided, a project selection prompt will be shown."),
         workItemType: z.string().describe("The type of the child work item to create."),
         items: z.array(z.object({
             title: z.string().describe("The title of the child work item."),
@@ -368,6 +453,13 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider, userA
     }, async ({ parentId, project, workItemType, items }) => {
         try {
             const connection = await connectionProvider();
+            let resolvedProject = project;
+            if (!resolvedProject) {
+                const result = await elicitProject(server, connection, "Select the Azure DevOps project to create child work items in.");
+                if ("response" in result)
+                    return result.response;
+                resolvedProject = result.resolved;
+            }
             const orgUrl = connection.serverUrl;
             const accessToken = await tokenProvider();
             if (items.length > 50) {
@@ -404,7 +496,7 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider, userA
                         path: "/relations/-",
                         value: {
                             rel: "System.LinkTypes.Hierarchy-Reverse",
-                            url: `${connection.serverUrl}/${project}/_apis/wit/workItems/${parentId}`,
+                            url: `${connection.serverUrl}/${resolvedProject}/_apis/wit/workItems/${parentId}`,
                         },
                     },
                 ];
@@ -436,7 +528,7 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider, userA
                 }
                 return {
                     method: "PATCH",
-                    uri: `/${encodeURIComponent(project)}/_apis/wit/workitems/$${encodeURIComponent(workItemType)}?api-version=${batchApiVersion}`,
+                    uri: `/${encodeURIComponent(resolvedProject)}/_apis/wit/workitems/$${encodeURIComponent(workItemType)}?api-version=${batchApiVersion}`,
                     headers: {
                         "Content-Type": "application/json-patch+json",
                     },
@@ -523,16 +615,23 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider, userA
             };
         }
     });
-    server.tool(WORKITEM_TOOLS.get_work_items_for_iteration, "Retrieve a list of work items for a specified iteration.", {
-        project: z.string().describe("The name or ID of the Azure DevOps project."),
+    server.tool(WORKITEM_TOOLS.get_work_items_for_iteration, "Retrieve a list of work items for a specified iteration. If a project is not specified, you will be prompted to select one.", {
+        project: z.string().optional().describe("The name or ID of the Azure DevOps project. Reuse from prior context if already known. If not provided, a project selection prompt will be shown."),
         team: z.string().optional().describe("The name or ID of the Azure DevOps team. If not provided, the default team will be used."),
         iterationId: z.string().describe("The ID of the iteration to retrieve work items for."),
     }, async ({ project, team, iterationId }) => {
         try {
             const connection = await connectionProvider();
+            let resolvedProject = project;
+            if (!resolvedProject) {
+                const result = await elicitProject(server, connection, "Select the Azure DevOps project to retrieve work items for iteration.");
+                if ("response" in result)
+                    return result.response;
+                resolvedProject = result.resolved;
+            }
             const workApi = await connection.getWorkApi();
             //get the work items for the current iteration
-            const workItems = await workApi.getIterationWorkItems({ project, team }, iterationId);
+            const workItems = await workApi.getIterationWorkItems({ project: resolvedProject, team }, iterationId);
             return {
                 content: [{ type: "text", text: JSON.stringify(workItems, null, 2) }],
             };
@@ -581,14 +680,21 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider, userA
             };
         }
     });
-    server.tool(WORKITEM_TOOLS.get_work_item_type, "Get a specific work item type.", {
-        project: z.string().describe("The name or ID of the Azure DevOps project."),
+    server.tool(WORKITEM_TOOLS.get_work_item_type, "Get a specific work item type. If a project is not specified, you will be prompted to select one.", {
+        project: z.string().optional().describe("The name or ID of the Azure DevOps project. Reuse from prior context if already known. If not provided, a project selection prompt will be shown."),
         workItemType: z.string().describe("The name of the work item type to retrieve."),
     }, async ({ project, workItemType }) => {
         try {
             const connection = await connectionProvider();
+            let resolvedProject = project;
+            if (!resolvedProject) {
+                const result = await elicitProject(server, connection, "Select the Azure DevOps project to retrieve the work item type from.");
+                if ("response" in result)
+                    return result.response;
+                resolvedProject = result.resolved;
+            }
             const workItemApi = await connection.getWorkItemTrackingApi();
-            const workItemTypeInfo = await workItemApi.getWorkItemType(project, workItemType);
+            const workItemTypeInfo = await workItemApi.getWorkItemType(resolvedProject, workItemType);
             return {
                 content: [{ type: "text", text: JSON.stringify(workItemTypeInfo, null, 2) }],
             };
@@ -601,8 +707,8 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider, userA
             };
         }
     });
-    server.tool(WORKITEM_TOOLS.create_work_item, "Create a new work item in a specified project and work item type.", {
-        project: z.string().describe("The name or ID of the Azure DevOps project."),
+    server.tool(WORKITEM_TOOLS.create_work_item, "Create a new work item in a specified project and work item type. If a project is not specified, you will be prompted to select one.", {
+        project: z.string().optional().describe("The name or ID of the Azure DevOps project. Reuse from prior context if already known. If not provided, a project selection prompt will be shown."),
         workItemType: z.string().describe("The type of work item to create, e.g., 'Task', 'Bug', etc."),
         fields: z
             .array(z.object({
@@ -614,6 +720,13 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider, userA
     }, async ({ project, workItemType, fields }) => {
         try {
             const connection = await connectionProvider();
+            let resolvedProject = project;
+            if (!resolvedProject) {
+                const result = await elicitProject(server, connection, "Select the Azure DevOps project to create the work item in.");
+                if ("response" in result)
+                    return result.response;
+                resolvedProject = result.resolved;
+            }
             const workItemApi = await connection.getWorkItemTrackingApi();
             const document = fields.map(({ name, value, format }) => ({
                 op: "add",
@@ -632,7 +745,7 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider, userA
                     });
                 }
             });
-            const newWorkItem = await workItemApi.createWorkItem(null, document, project, workItemType);
+            const newWorkItem = await workItemApi.createWorkItem(null, document, resolvedProject, workItemType);
             if (!newWorkItem) {
                 return { content: [{ type: "text", text: "Work item was not created" }], isError: true };
             }
@@ -648,8 +761,8 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider, userA
             };
         }
     });
-    server.tool(WORKITEM_TOOLS.get_query, "Get a query by its ID or path.", {
-        project: z.string().describe("The name or ID of the Azure DevOps project."),
+    server.tool(WORKITEM_TOOLS.get_query, "Get a query by its ID or path. If a project is not specified, you will be prompted to select one.", {
+        project: z.string().optional().describe("The name or ID of the Azure DevOps project. Reuse from prior context if already known. If not provided, a project selection prompt will be shown."),
         query: z.string().describe("The ID or path of the query to retrieve."),
         expand: z
             .enum(getEnumKeys(QueryExpand))
@@ -661,8 +774,15 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider, userA
     }, async ({ project, query, expand, depth, includeDeleted, useIsoDateFormat }) => {
         try {
             const connection = await connectionProvider();
+            let resolvedProject = project;
+            if (!resolvedProject) {
+                const result = await elicitProject(server, connection, "Select the Azure DevOps project to retrieve the query from.");
+                if ("response" in result)
+                    return result.response;
+                resolvedProject = result.resolved;
+            }
             const workItemApi = await connection.getWorkItemTrackingApi();
-            const queryDetails = await workItemApi.getQuery(project, query, safeEnumConvert(QueryExpand, expand), depth, includeDeleted, useIsoDateFormat);
+            const queryDetails = await workItemApi.getQuery(resolvedProject, query, safeEnumConvert(QueryExpand, expand), depth, includeDeleted, useIsoDateFormat);
             return {
                 content: [{ type: "text", text: JSON.stringify(queryDetails, null, 2) }],
             };
@@ -776,8 +896,8 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider, userA
             };
         }
     });
-    server.tool(WORKITEM_TOOLS.work_items_link, "Link work items together in batch.", {
-        project: z.string().describe("The name or ID of the Azure DevOps project."),
+    server.tool(WORKITEM_TOOLS.work_items_link, "Link work items together in batch. If a project is not specified, you will be prompted to select one.", {
+        project: z.string().optional().describe("The name or ID of the Azure DevOps project. Reuse from prior context if already known. If not provided, a project selection prompt will be shown."),
         updates: z
             .array(z.object({
             id: z.coerce.number().min(1).describe("The ID of the work item to update."),
@@ -792,6 +912,13 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider, userA
     }, async ({ project, updates }) => {
         try {
             const connection = await connectionProvider();
+            let resolvedProject = project;
+            if (!resolvedProject) {
+                const result = await elicitProject(server, connection, "Select the Azure DevOps project to link work items in.");
+                if ("response" in result)
+                    return result.response;
+                resolvedProject = result.resolved;
+            }
             const orgUrl = connection.serverUrl;
             const accessToken = await tokenProvider();
             // Extract unique IDs from the updates array
@@ -809,7 +936,7 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider, userA
                     path: "/relations/-",
                     value: {
                         rel: `${getLinkTypeFromName(type)}`,
-                        url: `${orgUrl}/${project}/_apis/wit/workItems/${linkToId}`,
+                        url: `${orgUrl}/${resolvedProject}/_apis/wit/workItems/${linkToId}`,
                         attributes: {
                             comment: comment || "",
                         },
@@ -841,8 +968,8 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider, userA
             };
         }
     });
-    server.tool(WORKITEM_TOOLS.work_item_unlink, "Remove one or many links from a single work item", {
-        project: z.string().describe("The name or ID of the Azure DevOps project."),
+    server.tool(WORKITEM_TOOLS.work_item_unlink, "Remove one or many links from a single work item. If a project is not specified, you will be prompted to select one.", {
+        project: z.string().optional().describe("The name or ID of the Azure DevOps project. Reuse from prior context if already known. If not provided, a project selection prompt will be shown."),
         id: z.coerce.number().min(1).describe("The ID of the work item to remove the links from."),
         type: z
             .enum(["parent", "child", "duplicate", "duplicate of", "related", "successor", "predecessor", "tested by", "tests", "affects", "affected by", "artifact"])
@@ -852,8 +979,15 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider, userA
     }, async ({ project, id, type, url }) => {
         try {
             const connection = await connectionProvider();
+            let resolvedProject = project;
+            if (!resolvedProject) {
+                const result = await elicitProject(server, connection, "Select the Azure DevOps project to unlink work items in.");
+                if ("response" in result)
+                    return result.response;
+                resolvedProject = result.resolved;
+            }
             const workItemApi = await connection.getWorkItemTrackingApi();
-            const workItem = await workItemApi.getWorkItem(id, undefined, undefined, WorkItemExpand.Relations, project);
+            const workItem = await workItemApi.getWorkItem(id, undefined, undefined, WorkItemExpand.Relations, resolvedProject);
             const relations = workItem.relations ?? [];
             const linkType = getLinkTypeFromName(type);
             let relationIndexes = [];
@@ -879,7 +1013,7 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider, userA
                 op: "remove",
                 path: `/relations/${idx}`,
             }));
-            const updatedWorkItem = await workItemApi.updateWorkItem(null, apiUpdates, id, project);
+            const updatedWorkItem = await workItemApi.updateWorkItem(null, apiUpdates, id, resolvedProject);
             return {
                 content: [
                     {
@@ -905,9 +1039,9 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider, userA
             };
         }
     });
-    server.tool(WORKITEM_TOOLS.add_artifact_link, "Add artifact links (repository, branch, commit, builds) to work items. You can either provide the full vstfs URI or the individual components to build it automatically.", {
+    server.tool(WORKITEM_TOOLS.add_artifact_link, "Add artifact links (repository, branch, commit, builds) to work items. You can either provide the full vstfs URI or the individual components to build it automatically. If a project is not specified, you will be prompted to select one.", {
         workItemId: z.coerce.number().min(1).describe("The ID of the work item to add the artifact link to."),
-        project: z.string().describe("The name or ID of the Azure DevOps project."),
+        project: z.string().optional().describe("The name or ID of the Azure DevOps project. Reuse from prior context if already known. If not provided, a project selection prompt will be shown."),
         // Option 1: Provide full URI directly
         artifactUri: z.string().optional().describe("The complete VSTFS URI of the artifact to link. If provided, individual component parameters are ignored."),
         // Option 2: Provide individual components to build URI automatically based on linkType
@@ -940,6 +1074,13 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider, userA
     }, async ({ workItemId, project, artifactUri, projectId, repositoryId, branchName, commitId, pullRequestId, buildId, linkType, comment }) => {
         try {
             const connection = await connectionProvider();
+            let resolvedProject = project;
+            if (!resolvedProject) {
+                const result = await elicitProject(server, connection, "Select the Azure DevOps project to add the artifact link in.");
+                if ("response" in result)
+                    return result.response;
+                resolvedProject = result.resolved;
+            }
             const workItemTrackingApi = await connection.getWorkItemTrackingApi();
             let finalArtifactUri;
             if (artifactUri) {
@@ -1010,7 +1151,7 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider, userA
                 },
             ];
             // Use the WorkItem API to update the work item with the new relation
-            const workItem = await workItemTrackingApi.updateWorkItem({}, patchDocument, workItemId, project);
+            const workItem = await workItemTrackingApi.updateWorkItem({}, patchDocument, workItemId, resolvedProject);
             if (!workItem) {
                 return { content: [{ type: "text", text: "Work item update failed" }], isError: true };
             }
@@ -1066,15 +1207,22 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider, userA
             };
         }
     });
-    server.tool(WORKITEM_TOOLS.get_work_item_attachment, "Download a work item attachment by its ID and return the content as a base64-encoded resource. Useful for viewing images (e.g. screenshots) attached to work items such as bugs.", {
-        project: z.string().describe("The name or ID of the Azure DevOps project."),
+    server.tool(WORKITEM_TOOLS.get_work_item_attachment, "Download a work item attachment by its ID and return the content as a base64-encoded resource. Useful for viewing images (e.g. screenshots) attached to work items such as bugs. If a project is not specified, you will be prompted to select one.", {
+        project: z.string().optional().describe("The name or ID of the Azure DevOps project. Reuse from prior context if already known. If not provided, a project selection prompt will be shown."),
         attachmentId: z.string().describe("The GUID of the attachment. Found in the attachment URL: https://dev.azure.com/{org}/{project}/_apis/wit/attachments/{attachmentId}"),
         fileName: z.string().optional().describe("The file name of the attachment, e.g. 'screenshot.png'. Used to determine the MIME type for the returned resource."),
     }, async ({ project, attachmentId, fileName }) => {
         try {
             const connection = await connectionProvider();
+            let resolvedProject = project;
+            if (!resolvedProject) {
+                const result = await elicitProject(server, connection, "Select the Azure DevOps project to retrieve the work item attachment from.");
+                if ("response" in result)
+                    return result.response;
+                resolvedProject = result.resolved;
+            }
             const workItemApi = await connection.getWorkItemTrackingApi();
-            const stream = await workItemApi.getAttachmentContent(attachmentId, fileName, project);
+            const stream = await workItemApi.getAttachmentContent(attachmentId, fileName, resolvedProject);
             const chunks = [];
             await new Promise((resolve, reject) => {
                 stream.on("data", (chunk) => chunks.push(Buffer.from(chunk)));

package/dist/version.js

@@ -1 +1 @@
-export const packageVersion = "2.5.0-nightly.20260412";
+export const packageVersion = "2.5.0-nightly.20260414";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@azure-devops/mcp",
-  "version": "2.5.0-nightly.20260412",
+  "version": "2.5.0-nightly.20260414",
   "mcpName": "microsoft.com/azure-devops",
   "description": "MCP server for interacting with Azure DevOps",
   "license": "MIT",