@azure-devops/mcp 2.2.1-nightly.20251103 → 2.2.1-nightly.20251104

package/README.md

@@ -53,6 +53,7 @@ Interact with these Azure DevOps services:
 ### ⚒️ Work
 
 - **work_list_team_iterations**: Retrieve a list of iterations for a specific team in a project.
+- **work_list_iterations**: List all iterations in a specified Azure DevOps project.
 - **work_create_iterations**: Create new iterations in a specified Azure DevOps project.
 - **work_assign_iterations**: Assign existing iterations to a specific team in a project.
 - **work_get_team_capacity**: Get the team capacity of a specific team and iteration in a project.

package/dist/tools/work-items.js

@@ -56,7 +56,7 @@ function getLinkTypeFromName(name) {
     }
 }
 function configureWorkItemTools(server, tokenProvider, connectionProvider, userAgentProvider) {
-    server.tool(WORKITEM_TOOLS.list_backlogs, "Revieve a list of backlogs for a given project and team.", {
+    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."),
     }, async ({ project, team }) => {

package/dist/tools/work.js

@@ -1,9 +1,10 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT License.
 import { z } from "zod";
-import { TreeStructureGroup } from "azure-devops-node-api/interfaces/WorkItemTrackingInterfaces.js";
+import { TreeStructureGroup, TreeNodeStructureType } from "azure-devops-node-api/interfaces/WorkItemTrackingInterfaces.js";
 const WORK_TOOLS = {
     list_team_iterations: "work_list_team_iterations",
+    list_iterations: "work_list_iterations",
     create_iterations: "work_create_iterations",
     assign_iterations: "work_assign_iterations",
     get_team_capacity: "work_get_team_capacity",
@@ -77,6 +78,59 @@ 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 }) => {
+        try {
+            const connection = await connectionProvider();
+            const workItemTrackingApi = await connection.getWorkItemTrackingApi();
+            const results = [];
+            if (depth === undefined) {
+                depth = 1;
+            }
+            // Get all root nodes, then filter for the root node with structureType "iteration"
+            const rootNodes = await workItemTrackingApi.getRootNodes(project, depth);
+            const iterationRoot = Array.isArray(rootNodes) ? rootNodes.find((node) => node.structureType === TreeNodeStructureType.Iteration) : undefined;
+            if (iterationRoot) {
+                // Only return the root and its children (if any)
+                results.push({
+                    id: iterationRoot.id,
+                    identifier: iterationRoot.identifier,
+                    name: iterationRoot.name,
+                    structureType: iterationRoot.structureType,
+                    hasChildren: iterationRoot.hasChildren,
+                    path: iterationRoot.path,
+                    url: iterationRoot.url,
+                    children: iterationRoot.children
+                        ? iterationRoot.children.map((child) => ({
+                            id: child.id,
+                            identifier: child.identifier,
+                            name: child.name,
+                            structureType: child.structureType,
+                            hasChildren: child.hasChildren,
+                            path: child.path,
+                            url: child.url,
+                            attributes: child.attributes,
+                        }))
+                        : [],
+                });
+            }
+            if (results.length === 0) {
+                return { content: [{ type: "text", text: "No iterations were found" }], isError: true };
+            }
+            return {
+                content: [{ type: "text", text: JSON.stringify(results, null, 2) }],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : "Unknown error occurred";
+            return {
+                content: [{ type: "text", text: `Error fetching iterations: ${errorMessage}` }],
+                isError: true,
+            };
+        }
+    });
     server.tool(WORK_TOOLS.assign_iterations, "Assign existing iterations to a specific team in a project.", {
         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."),

package/dist/version.js

@@ -1 +1 @@
-export const packageVersion = "2.2.1-nightly.20251103";
+export const packageVersion = "2.2.1-nightly.20251104";

package/package.json

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