@azure-devops/mcp 2.4.0-nightly.20260315 → 2.4.0-nightly.20260317

package/README.md

@@ -1,5 +1,10 @@
 # ⭐ Azure DevOps MCP Server
 
+> [!IMPORTANT]
+> The Azure DevOps Remote MCP Server is now available in public preview for all organizations. We recommend migrating to the [Remote MCP Server](https://learn.microsoft.com/en-us/azure/devops/mcp-server/remote-mcp-server) going forward.
+>
+> [Learn more](#-remote-mcp-server)
+
 Easily install the Azure DevOps MCP Server for VS Code or VS Code Insiders:
 
 [![Install with NPX in VS Code](https://img.shields.io/badge/VS_Code-Install_AzureDevops_MCP_Server-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=ado&config=%7B%20%22type%22%3A%20%22stdio%22%2C%20%22command%22%3A%20%22npx%22%2C%20%22args%22%3A%20%5B%22-y%22%2C%20%22%40azure-devops%2Fmcp%22%2C%20%22%24%7Binput%3Aado_org%7D%22%5D%7D&inputs=%5B%7B%22id%22%3A%20%22ado_org%22%2C%20%22type%22%3A%20%22promptString%22%2C%20%22description%22%3A%20%22Azure%20DevOps%20organization%20name%20%20%28e.g.%20%27contoso%27%29%22%7D%5D)
@@ -11,13 +16,14 @@ This TypeScript project provides a **local** MCP server for Azure DevOps, enabli
 
 1. [📺 Overview](#-overview)
 2. [🏆 Expectations](#-expectations)
-3. [⚙️ Supported Tools](#️-supported-tools)
-4. [🔌 Installation & Getting Started](#-installation--getting-started)
-5. [🌏 Using Domains](#-using-domains)
-6. [📝 Troubleshooting](#-troubleshooting)
-7. [🎩 Examples & Best Practices](#-examples--best-practices)
-8. [🙋‍♀️ Frequently Asked Questions](#️-frequently-asked-questions)
-9. [📌 Contributing](#-contributing)
+3. [🚀 Remote MCP Server](#-remote-mcp-server)
+4. [⚙️ Supported Tools](#️-supported-tools)
+5. [🔌 Installation & Getting Started](#-installation--getting-started)
+6. [🌏 Using Domains](#-using-domains)
+7. [📝 Troubleshooting](#-troubleshooting)
+8. [🎩 Examples & Best Practices](#-examples--best-practices)
+9. [🙋‍♀️ Frequently Asked Questions](#️-frequently-asked-questions)
+10. [📌 Contributing](#-contributing)
 
 ## 📺 Overview
 
@@ -40,6 +46,21 @@ The Azure DevOps MCP Server brings Azure DevOps context to your agents. Try prom
 
 The Azure DevOps MCP Server is built from tools that are concise, simple, focused, and easy to use—each designed for a specific scenario. We intentionally avoid complex tools that try to do too much. The goal is to provide a thin abstraction layer over the REST APIs, making data access straightforward and letting the language model handle complex reasoning.
 
+## 🚀 Remote MCP Server
+
+The Azure DevOps **Remote MCP Server** is now available in [public preview](https://devblogs.microsoft.com/devops/azure-devops-remote-mcp-server-public-preview).
+
+Over time, the Remote MCP Server will replace this local MCP Server. We will continue to support the local server for now, but future investments will primarily focus on the remote experience.
+
+We encourage all users of the local MCP Server to begin migrating to the Remote MCP Server.
+
+If you encounter issues with tools, need support, or have a feature request, you can report an issue using the [Remote MCP Server issue template](https://github.com/microsoft/azure-devops-mcp/issues/new?template=remote-mcp-server-issue.md). During the preview period, we will track Remote MCP Server issues through this repository.
+
+> [!WARNING]
+> Internal Microsoft users of the Remote MCP Server should **not** create issues in this repository. Please use the dedicated Teams channel instead.
+
+For instructions on how to get started with the Remote MCP Server, see the [onboarding documentation](https://learn.microsoft.com/en-us/azure/devops/mcp-server/remote-mcp-server).
+
 ## ⚙️ Supported Tools
 
 See [TOOLSET.md](./docs/TOOLSET.md) for a comprehensive list.

package/dist/shared/elicitations.js

@@ -0,0 +1,62 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+export async function elicitProject(server, connection, message) {
+    const coreApi = await connection.getCoreApi();
+    const projects = await coreApi.getProjects("wellFormed", 100, 0, undefined, false);
+    if (!projects || projects.length === 0) {
+        return { response: { content: [{ type: "text", text: "No projects found to select from." }], isError: true } };
+    }
+    const result = await server.server.elicitInput({
+        mode: "form",
+        message: message ?? "Select the Azure DevOps project.",
+        requestedSchema: {
+            type: "object",
+            properties: {
+                project: {
+                    type: "string",
+                    title: "Project",
+                    description: "The Azure DevOps project.",
+                    oneOf: projects.map((p) => ({
+                        const: p.name ?? p.id ?? "",
+                        title: p.name ?? p.id ?? "Unknown project",
+                    })),
+                },
+            },
+            required: ["project"],
+        },
+    });
+    if (result.action !== "accept" || !result.content?.project) {
+        return { response: { content: [{ type: "text", text: "Project selection cancelled." }] } };
+    }
+    return { resolved: String(result.content.project) };
+}
+export async function elicitTeam(server, connection, project, message) {
+    const coreApi = await connection.getCoreApi();
+    const teams = await coreApi.getTeams(project, undefined, undefined, undefined, false);
+    if (!teams || teams.length === 0) {
+        return { response: { content: [{ type: "text", text: "No teams found to select from." }], isError: true } };
+    }
+    const result = await server.server.elicitInput({
+        mode: "form",
+        message: message ?? "Select the team.",
+        requestedSchema: {
+            type: "object",
+            properties: {
+                team: {
+                    type: "string",
+                    title: "Team",
+                    description: "The team from a specific Azure DevOps project.",
+                    oneOf: teams.map((t) => ({
+                        const: t.name ?? t.id ?? "",
+                        title: t.name ?? t.id ?? "Unknown team",
+                    })),
+                },
+            },
+            required: ["team"],
+        },
+    });
+    if (result.action !== "accept" || !result.content?.team) {
+        return { response: { content: [{ type: "text", text: "Team selection cancelled." }] } };
+    }
+    return { resolved: String(result.content.team) };
+}

package/dist/tools/core.js

@@ -2,6 +2,7 @@
 // Licensed under the MIT License.
 import { z } from "zod";
 import { searchIdentities } from "./auth.js";
+import { elicitProject } from "../shared/elicitations.js";
 const CORE_TOOLS = {
     list_project_teams: "core_list_project_teams",
     list_projects: "core_list_projects",
@@ -13,7 +14,7 @@ function filterProjectsByName(projects, projectNameFilter) {
 }
 function configureCoreTools(server, tokenProvider, connectionProvider, userAgentProvider) {
     server.tool(CORE_TOOLS.list_project_teams, "Retrieve a list of teams for an Azure DevOps project. 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. If not provided, a project selection prompt will be shown."),
+        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."),
         mine: z.boolean().optional().describe("If true, only return teams that the authenticated user is a member of."),
         top: z.number().optional().describe("The maximum number of teams to return. Defaults to 100."),
         skip: z.number().optional().describe("The number of teams to skip for pagination. Defaults to 0."),
@@ -23,33 +24,10 @@ function configureCoreTools(server, tokenProvider, connectionProvider, userAgent
             const coreApi = await connection.getCoreApi();
             let resolvedProject = project;
             if (!resolvedProject) {
-                const projects = await coreApi.getProjects("wellFormed", 100, 0, undefined, false);
-                if (!projects || projects.length === 0) {
-                    return { content: [{ type: "text", text: "No projects found to select from." }], isError: true };
-                }
-                const result = await server.server.elicitInput({
-                    mode: "form",
-                    message: "Select the Azure DevOps project to list teams for.",
-                    requestedSchema: {
-                        type: "object",
-                        properties: {
-                            project: {
-                                type: "string",
-                                title: "Project",
-                                description: "The Azure DevOps project to list teams for.",
-                                oneOf: projects.map((p) => ({
-                                    const: p.name ?? p.id ?? "",
-                                    title: p.name ?? p.id ?? "Unknown project",
-                                })),
-                            },
-                        },
-                        required: ["project"],
-                    },
-                });
-                if (result.action !== "accept" || !result.content?.project) {
-                    return { content: [{ type: "text", text: "Project selection cancelled." }] };
-                }
-                resolvedProject = String(result.content.project);
+                const result = await elicitProject(server, connection, "Select the Azure DevOps project to list teams for.");
+                if ("response" in result)
+                    return result.response;
+                resolvedProject = result.resolved;
             }
             const teams = await coreApi.getTeams(resolvedProject, mine, top, skip, false);
             if (!teams) {

package/dist/tools/work.js

@@ -2,6 +2,7 @@
 // Licensed under the MIT License.
 import { z } from "zod";
 import { TreeStructureGroup, TreeNodeStructureType } from "azure-devops-node-api/interfaces/WorkItemTrackingInterfaces.js";
+import { elicitProject, elicitTeam } from "../shared/elicitations.js";
 const WORK_TOOLS = {
     list_team_iterations: "work_list_team_iterations",
     list_iterations: "work_list_iterations",
@@ -13,20 +14,37 @@ const WORK_TOOLS = {
     get_team_settings: "work_get_team_settings",
 };
 function configureWorkTools(server, _, connectionProvider) {
-    server.tool(WORK_TOOLS.list_team_iterations, "Retrieve a list of iterations for 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."),
+    server.tool(WORK_TOOLS.list_team_iterations, "Retrieve a list of iterations for a specific team in a project. 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."),
         timeframe: z.enum(["current"]).optional().describe("The timeframe for which to retrieve iterations. Currently, only 'current' is supported."),
     }, async ({ project, team, timeframe }) => {
         try {
             const connection = await connectionProvider();
+            let resolvedProject = project;
+            if (!resolvedProject) {
+                const result = await elicitProject(server, connection, "Select the Azure DevOps project to list team iterations 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 iterations for.");
+                if ("response" in result)
+                    return result.response;
+                resolvedTeam = result.resolved;
+            }
             const workApi = await connection.getWorkApi();
-            const iterations = await workApi.getTeamIterations({ project, team }, timeframe);
+            const iterations = await workApi.getTeamIterations({ project: resolvedProject, team: resolvedTeam }, timeframe);
             if (!iterations) {
                 return { content: [{ type: "text", text: "No iterations found" }], isError: true };
             }
             return {
-                content: [{ type: "text", text: JSON.stringify(iterations, null, 2) }],
+                content: [
+                    { type: "text", text: `Project: ${resolvedProject}, Team: ${resolvedTeam}` },
+                    { type: "text", text: JSON.stringify(iterations, null, 2) },
+                ],
             };
         }
         catch (error) {
@@ -79,19 +97,26 @@ 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."),
+    server.tool(WORK_TOOLS.list_iterations, "List all iterations in a specified Azure DevOps project. 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."),
         depth: z.number().default(2).describe("Depth of children to fetch."),
         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();
+            let resolvedProject = project;
+            if (!resolvedProject) {
+                const result = await elicitProject(server, connection, "Select the Azure DevOps project to list iterations for.");
+                if ("response" in result)
+                    return result.response;
+                resolvedProject = result.resolved;
+            }
             const workItemTrackingApi = await connection.getWorkItemTrackingApi();
             let results = [];
             if (depth === undefined) {
                 depth = 1;
             }
-            results = await workItemTrackingApi.getClassificationNodes(project, [], depth);
+            results = await workItemTrackingApi.getClassificationNodes(resolvedProject, [], depth);
             // Handle null or undefined results
             if (!results) {
                 return { content: [{ type: "text", text: "No iterations were found" }], isError: true };
@@ -166,15 +191,22 @@ 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."),
+    server.tool(WORK_TOOLS.get_team_capacity, "Get the team capacity of a specific team and iteration in a project. 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().describe("The name or Id of the Azure DevOps team. Reuse from prior context if already known."),
         iterationId: z.string().describe("The Iteration Id to get capacity 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 get team capacity for.");
+                if ("response" in result)
+                    return result.response;
+                resolvedProject = result.resolved;
+            }
             const workApi = await connection.getWorkApi();
-            const teamContext = { project, team };
+            const teamContext = { project: resolvedProject, 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 };
@@ -272,14 +304,21 @@ function configureWorkTools(server, _, connectionProvider) {
             };
         }
     });
-    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."),
+    server.tool(WORK_TOOLS.get_iteration_capacities, "Get an iteration's capacity for all teams in iteration and project. 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."),
         iterationId: z.string().describe("The Iteration Id to get capacity for."),
     }, async ({ project, iterationId }) => {
         try {
             const connection = await connectionProvider();
+            let resolvedProject = project;
+            if (!resolvedProject) {
+                const result = await elicitProject(server, connection, "Select the Azure DevOps project to get iteration capacities for.");
+                if ("response" in result)
+                    return result.response;
+                resolvedProject = result.resolved;
+            }
             const workApi = await connection.getWorkApi();
-            const rawResults = await workApi.getTotalIterationCapacities(project, iterationId);
+            const rawResults = await workApi.getTotalIterationCapacities(resolvedProject, iterationId);
             if (!rawResults || !rawResults.teams || rawResults.teams.length === 0) {
                 return { content: [{ type: "text", text: "No iteration capacity assigned to the teams" }], isError: true };
             }
@@ -295,14 +334,28 @@ function configureWorkTools(server, _, connectionProvider) {
             };
         }
     });
-    server.tool(WORK_TOOLS.get_team_settings, "Get team settings including default iteration, backlog iteration, and default area path for a team.", {
-        project: z.string().describe("The name or ID of the Azure DevOps project."),
-        team: z.string().optional().describe("The name or ID of the Azure DevOps team. If not provided, the default team will be used."),
+    server.tool(WORK_TOOLS.get_team_settings, "Get team settings including default iteration, backlog iteration, and default area path for a 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 get team settings 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 get settings 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 teamSettings = await workApi.getTeamSettings(teamContext);
             if (!teamSettings) {
                 return { content: [{ type: "text", text: "No team settings found" }], isError: true };
@@ -320,7 +373,10 @@ function configureWorkTools(server, _, connectionProvider) {
                 areaPaths: teamFieldValues?.values,
             };
             return {
-                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+                content: [
+                    { type: "text", text: `Project: ${resolvedProject}, Team: ${resolvedTeam}` },
+                    { type: "text", text: JSON.stringify(result, null, 2) },
+                ],
             };
         }
         catch (error) {

package/dist/version.js

@@ -1 +1 @@
-export const packageVersion = "2.4.0-nightly.20260315";
+export const packageVersion = "2.4.0-nightly.20260317";

package/package.json

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