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

package/README.md

@@ -70,6 +70,7 @@ Interact with these Azure DevOps services:
 - **wit_update_work_item**: Update a work item by ID with specified fields.
 - **wit_create_work_item**: Create a new work item in a specified project and work item type.
 - **wit_list_work_item_comments**: Retrieve a list of comments for a work item by ID.
+- **wit_list_work_item_revisions**: Retrieve a list of revisions for a work item by ID.
 - **wit_get_work_items_for_iteration**: Retrieve a list of work items for a specified iteration.
 - **wit_add_work_item_comment**: Add a comment to a work item by ID.
 - **wit_add_child_work_items**: Create one or more child work items of a specific work item type for the given parent ID.

package/dist/tools/work-items.js

@@ -13,6 +13,7 @@ const WORKITEM_TOOLS = {
     update_work_item: "wit_update_work_item",
     create_work_item: "wit_create_work_item",
     list_work_item_comments: "wit_list_work_item_comments",
+    list_work_item_revisions: "wit_list_work_item_revisions",
     get_work_items_for_iteration: "wit_get_work_items_for_iteration",
     add_work_item_comment: "wit_add_work_item_comment",
     add_child_work_items: "wit_add_child_work_items",
@@ -195,6 +196,49 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider, userA
             content: [{ type: "text", text: comments }],
         };
     });
+    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."),
+        workItemId: z.number().describe("The ID of the work item to retrieve revisions for."),
+        top: z.number().default(50).describe("Optional number of revisions to retrieve. If not provided, all revisions will be returned."),
+        skip: z.number().optional().describe("Optional number of revisions to skip for pagination. Defaults to 0."),
+        expand: z
+            .enum(getEnumKeys(WorkItemExpand))
+            .default("None")
+            .optional()
+            .describe("Optional expand parameter to include additional details. Defaults to 'None'."),
+    }, async ({ project, workItemId, top, skip, expand }) => {
+        const connection = await connectionProvider();
+        const workItemApi = await connection.getWorkItemTrackingApi();
+        const revisions = await workItemApi.getRevisions(workItemId, top, skip, safeEnumConvert(WorkItemExpand, expand), project);
+        // 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)) {
+            revisions.forEach((revision) => {
+                if (revision.fields) {
+                    Object.keys(revision.fields).forEach((fieldName) => {
+                        const fieldValue = revision.fields ? revision.fields[fieldName] : undefined;
+                        // Check if this is an identity object by looking for common identity properties
+                        if (fieldValue &&
+                            typeof fieldValue === "object" &&
+                            !Array.isArray(fieldValue) &&
+                            "displayName" in fieldValue &&
+                            ("url" in fieldValue || "_links" in fieldValue || "uniqueName" in fieldValue)) {
+                            // Remove unwanted properties from identity objects
+                            delete fieldValue.url;
+                            delete fieldValue._links;
+                            delete fieldValue.id;
+                            delete fieldValue.uniqueName;
+                            delete fieldValue.imageUrl;
+                            delete fieldValue.descriptor;
+                        }
+                    });
+                }
+            });
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(revisions, null, 2) }],
+        };
+    });
     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.", {
         parentId: z.number().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."),

package/dist/version.js

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

package/package.json

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