@azure-devops/mcp 2.2.2-nightly.20251106 → 2.2.2-nightly.20251108

package/dist/tools/work-items.js

@@ -480,17 +480,26 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider, userA
             content: [{ type: "text", text: JSON.stringify(queryDetails, null, 2) }],
         };
     });
-    server.tool(WORKITEM_TOOLS.get_query_results_by_id, "Retrieve the results of a work item query given the query ID.", {
+    server.tool(WORKITEM_TOOLS.get_query_results_by_id, "Retrieve the results of a work item query given the query ID. Supports full or IDs-only response types.", {
         id: z.string().describe("The ID of the query to retrieve results for."),
         project: z.string().optional().describe("The name or ID of the Azure DevOps project. If not provided, the default project will be used."),
         team: z.string().optional().describe("The name or ID of the Azure DevOps team. If not provided, the default team will be used."),
         timePrecision: z.boolean().optional().describe("Whether to include time precision in the results. Defaults to false."),
         top: z.number().default(50).describe("The maximum number of results to return. Defaults to 50."),
-    }, async ({ id, project, team, timePrecision, top }) => {
+        responseType: z.enum(["full", "ids"]).default("full").describe("Response type: 'full' returns complete query results (default), 'ids' returns only work item IDs for reduced payload size."),
+    }, async ({ id, project, team, timePrecision, top, responseType }) => {
         const connection = await connectionProvider();
         const workItemApi = await connection.getWorkItemTrackingApi();
         const teamContext = { project, team };
         const queryResult = await workItemApi.queryById(id, teamContext, timePrecision, top);
+        // If ids mode, extract and return only the IDs
+        if (responseType === "ids") {
+            const ids = queryResult.workItems?.map((workItem) => workItem.id).filter((id) => id !== undefined) || [];
+            return {
+                content: [{ type: "text", text: JSON.stringify({ ids, count: ids.length }, null, 2) }],
+            };
+        }
+        // Default: return full query results
         return {
             content: [{ type: "text", text: JSON.stringify(queryResult, null, 2) }],
         };

package/dist/tools/work.js

@@ -81,20 +81,39 @@ function configureWorkTools(server, _, connectionProvider) {
     server.tool(WORK_TOOLS.list_iterations, "List all iterations in a specified Azure DevOps project.", {
         project: z.string().describe("The name or ID of the Azure DevOps project."),
         depth: z.number().default(2).describe("Depth of children to fetch."),
-    }, async ({ project, depth }) => {
+        excludedIds: z.array(z.number()).optional().describe("An optional array of iteration IDs, and thier children, that should not be returned."),
+    }, async ({ project, depth, excludedIds: ids }) => {
         try {
             const connection = await connectionProvider();
             const workItemTrackingApi = await connection.getWorkItemTrackingApi();
+            let results = [];
             if (depth === undefined) {
                 depth = 1;
             }
-            const results = await workItemTrackingApi.getClassificationNodes(project, [], depth);
+            results = await workItemTrackingApi.getClassificationNodes(project, [], depth);
             // Handle null or undefined results
             if (!results) {
                 return { content: [{ type: "text", text: "No iterations were found" }], isError: true };
             }
             // Filter out items with structureType=0 (Area nodes), only keep structureType=1 (Iteration nodes)
-            const filteredResults = results.filter((node) => node.structureType === TreeNodeStructureType.Iteration);
+            let filteredResults = results.filter((node) => node.structureType === TreeNodeStructureType.Iteration);
+            // If specific IDs are provided, filter them out recursively (exclude matching nodes and their children)
+            if (ids && ids.length > 0) {
+                const filterOutIds = (nodes) => {
+                    return nodes
+                        .filter((node) => !node.id || !ids.includes(node.id))
+                        .map((node) => {
+                        if (node.children && node.children.length > 0) {
+                            return {
+                                ...node,
+                                children: filterOutIds(node.children),
+                            };
+                        }
+                        return node;
+                    });
+                };
+                filteredResults = filterOutIds(filteredResults);
+            }
             if (filteredResults.length === 0) {
                 return { content: [{ type: "text", text: "No iterations were found" }], isError: true };
             }

package/dist/version.js

@@ -1 +1 @@
-export const packageVersion = "2.2.2-nightly.20251106";
+export const packageVersion = "2.2.2-nightly.20251108";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@azure-devops/mcp",
-  "version": "2.2.2-nightly.20251106",
+  "version": "2.2.2-nightly.20251108",
   "description": "MCP server for interacting with Azure DevOps",
   "license": "MIT",
   "author": "Microsoft Corporation",