@azure-devops/mcp 2.2.1-nightly.20251028 → 2.2.1-nightly.20251030

package/README.md

@@ -55,6 +55,9 @@ Interact with these Azure DevOps services:
 - **work_list_team_iterations**: Retrieve a list of iterations for a specific team in a 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.
+- **work_update_team_capacity**: Update the team capacity of a team member for a specific iteration in a project.
+- **work_get_iteration_capacities**: Get an iteration's capacity for all teams in iteration and project.
 
 ### 📅 Work Items
 

package/dist/auth.js

@@ -32,7 +32,7 @@ class OAuthAuthenticator {
                     account: this.accountId,
                 });
             }
-            catch (error) {
+            catch {
                 authResult = null;
             }
         }

package/dist/index.js

@@ -3,7 +3,7 @@
 // Licensed under the MIT License.
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import * as azdev from "azure-devops-node-api";
+import { getBearerHandler, WebApi } from "azure-devops-node-api";
 import yargs from "yargs";
 import { hideBin } from "yargs/helpers";
 import { createAuthenticator } from "./auth.js";
@@ -57,8 +57,8 @@ export const enabledDomains = domainsManager.getEnabledDomains();
 function getAzureDevOpsClient(getAzureDevOpsToken, userAgentComposer) {
     return async () => {
         const accessToken = await getAzureDevOpsToken();
-        const authHandler = azdev.getBearerHandler(accessToken);
-        const connection = new azdev.WebApi(orgUrl, authHandler, undefined, {
+        const authHandler = getBearerHandler(accessToken);
+        const connection = new WebApi(orgUrl, authHandler, undefined, {
             productName: "AzureDevOps.MCP",
             productVersion: packageVersion,
             userAgent: userAgentComposer.userAgent,

package/dist/org-tenants.js

@@ -1,23 +1,23 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT License.
-import * as fs from "fs/promises";
-import * as os from "os";
-import * as path from "path";
-const CACHE_FILE = path.join(os.homedir(), ".ado_orgs.cache");
+import { readFile, writeFile } from "fs/promises";
+import { homedir } from "os";
+import { join } from "path";
+const CACHE_FILE = join(homedir(), ".ado_orgs.cache");
 const CACHE_TTL_MS = 7 * 24 * 60 * 60 * 1000; // 1 week in milliseconds
 async function loadCache() {
     try {
-        const cacheData = await fs.readFile(CACHE_FILE, "utf-8");
+        const cacheData = await readFile(CACHE_FILE, "utf-8");
         return JSON.parse(cacheData);
     }
-    catch (error) {
+    catch {
         // Cache file doesn't exist or is invalid, return empty cache
         return {};
     }
 }
 async function trySavingCache(cache) {
     try {
-        await fs.writeFile(CACHE_FILE, JSON.stringify(cache, null, 2), "utf-8");
+        await writeFile(CACHE_FILE, JSON.stringify(cache, null, 2), "utf-8");
     }
     catch (error) {
         console.error("Failed to save org tenants cache:", error);

package/dist/tools/work.js

@@ -6,6 +6,9 @@ const WORK_TOOLS = {
     list_team_iterations: "work_list_team_iterations",
     create_iterations: "work_create_iterations",
     assign_iterations: "work_assign_iterations",
+    get_team_capacity: "work_get_team_capacity",
+    update_team_capacity: "work_update_team_capacity",
+    get_iteration_capacities: "work_get_iteration_capacities",
 };
 function configureWorkTools(server, _, connectionProvider) {
     server.tool(WORK_TOOLS.list_team_iterations, "Retrieve a list of iterations for a specific team in a project.", {
@@ -110,5 +113,134 @@ function configureWorkTools(server, _, connectionProvider) {
             };
         }
     });
+    server.tool(WORK_TOOLS.get_team_capacity, "Get the team capacity of a specific team and iteration 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."),
+        iterationId: z.string().describe("The Iteration Id to get capacity for."),
+    }, async ({ project, team, iterationId }) => {
+        try {
+            const connection = await connectionProvider();
+            const workApi = await connection.getWorkApi();
+            const teamContext = { project, team };
+            const rawResults = await workApi.getCapacitiesWithIdentityRefAndTotals(teamContext, iterationId);
+            if (!rawResults || rawResults.teamMembers?.length === 0) {
+                return { content: [{ type: "text", text: "No team capacity assigned to the team" }], isError: true };
+            }
+            // Remove unwanted fields from teamMember and url
+            const simplifiedResults = {
+                ...rawResults,
+                teamMembers: (rawResults.teamMembers || []).map((member) => {
+                    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+                    const { url, ...rest } = member;
+                    return {
+                        ...rest,
+                        teamMember: member.teamMember
+                            ? {
+                                displayName: member.teamMember.displayName,
+                                id: member.teamMember.id,
+                                uniqueName: member.teamMember.uniqueName,
+                            }
+                            : undefined,
+                    };
+                }),
+            };
+            return {
+                content: [{ type: "text", text: JSON.stringify(simplifiedResults, null, 2) }],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : "Unknown error occurred";
+            return {
+                content: [{ type: "text", text: `Error getting team capacity: ${errorMessage}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool(WORK_TOOLS.update_team_capacity, "Update the team capacity of a team member for a specific iteration 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."),
+        teamMemberId: z.string().describe("The team member Id for the specific team member."),
+        iterationId: z.string().describe("The Iteration Id to update the capacity for."),
+        activities: z
+            .array(z.object({
+            name: z.string().describe("The name of the activity (e.g., 'Development')."),
+            capacityPerDay: z.number().describe("The capacity per day for this activity."),
+        }))
+            .describe("Array of activities and their daily capacities for the team member."),
+        daysOff: z
+            .array(z.object({
+            start: z.string().describe("Start date of the day off in ISO format."),
+            end: z.string().describe("End date of the day off in ISO format."),
+        }))
+            .optional()
+            .describe("Array of days off for the team member, each with a start and end date in ISO format."),
+    }, async ({ project, team, teamMemberId, iterationId, activities, daysOff }) => {
+        try {
+            const connection = await connectionProvider();
+            const workApi = await connection.getWorkApi();
+            const teamContext = { project, team };
+            // Prepare the capacity update object
+            const capacityPatch = {
+                activities: activities.map((a) => ({
+                    name: a.name,
+                    capacityPerDay: a.capacityPerDay,
+                })),
+                daysOff: (daysOff || []).map((d) => ({
+                    start: new Date(d.start),
+                    end: new Date(d.end),
+                })),
+            };
+            // Update the team member's capacity
+            const updatedCapacity = await workApi.updateCapacityWithIdentityRef(capacityPatch, teamContext, iterationId, teamMemberId);
+            if (!updatedCapacity) {
+                return { content: [{ type: "text", text: "Failed to update team member capacity" }], isError: true };
+            }
+            // Simplify output
+            const simplifiedResult = {
+                teamMember: updatedCapacity.teamMember
+                    ? {
+                        displayName: updatedCapacity.teamMember.displayName,
+                        id: updatedCapacity.teamMember.id,
+                        uniqueName: updatedCapacity.teamMember.uniqueName,
+                    }
+                    : undefined,
+                activities: updatedCapacity.activities,
+                daysOff: updatedCapacity.daysOff,
+            };
+            return {
+                content: [{ type: "text", text: JSON.stringify(simplifiedResult, null, 2) }],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : "Unknown error occurred";
+            return {
+                content: [{ type: "text", text: `Error updating team capacity: ${errorMessage}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool(WORK_TOOLS.get_iteration_capacities, "Get an iteration's capacity for all teams in iteration and project.", {
+        project: z.string().describe("The name or Id of the Azure DevOps project."),
+        iterationId: z.string().describe("The Iteration Id to get capacity for."),
+    }, async ({ project, iterationId }) => {
+        try {
+            const connection = await connectionProvider();
+            const workApi = await connection.getWorkApi();
+            const rawResults = await workApi.getTotalIterationCapacities(project, iterationId);
+            if (!rawResults || !rawResults.teams || rawResults.teams.length === 0) {
+                return { content: [{ type: "text", text: "No iteration capacity assigned to the teams" }], isError: true };
+            }
+            return {
+                content: [{ type: "text", text: JSON.stringify(rawResults, null, 2) }],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : "Unknown error occurred";
+            return {
+                content: [{ type: "text", text: `Error getting iteration capacities: ${errorMessage}` }],
+                isError: true,
+            };
+        }
+    });
 }
 export { WORK_TOOLS, configureWorkTools };

package/dist/version.js

@@ -1 +1 @@
-export const packageVersion = "2.2.1-nightly.20251028";
+export const packageVersion = "2.2.1-nightly.20251030";

package/package.json

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