@azure-devops/mcp 2.5.0-nightly.20260407 → 2.5.0-nightly.20260409

package/dist/tools/test-plans.js

@@ -1,7 +1,7 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT License.
-import { SuiteExpand } from "azure-devops-node-api/interfaces/TestPlanInterfaces.js";
 import { z } from "zod";
+import { apiVersion } from "../utils.js";
 const Test_Plan_Tools = {
     create_test_plan: "testplan_create_test_plan",
     create_test_case: "testplan_create_test_case",
@@ -13,7 +13,7 @@ const Test_Plan_Tools = {
     list_test_suites: "testplan_list_test_suites",
     create_test_suite: "testplan_create_test_suite",
 };
-function configureTestPlanTools(server, _, connectionProvider) {
+function configureTestPlanTools(server, tokenProvider, connectionProvider, userAgentProvider) {
     server.tool(Test_Plan_Tools.list_test_plans, "Retrieve a paginated list of test plans from an Azure DevOps project. Allows filtering for active plans and toggling detailed information.", {
         project: z.string().describe("The unique identifier (ID or name) of the Azure DevOps project."),
         filterActivePlans: z.boolean().default(true).describe("Filter to include only active test plans. Defaults to true."),
@@ -21,12 +21,42 @@ function configureTestPlanTools(server, _, connectionProvider) {
         continuationToken: z.string().optional().describe("Token to continue fetching test plans from a previous request."),
     }, async ({ project, filterActivePlans, includePlanDetails, continuationToken }) => {
         try {
-            const owner = ""; //making owner an empty string untill we can figure out how to get owner id
             const connection = await connectionProvider();
-            const testPlanApi = await connection.getTestPlanApi();
-            const testPlans = await testPlanApi.getTestPlans(project, owner, continuationToken, includePlanDetails, filterActivePlans);
+            const accessToken = await tokenProvider();
+            const params = new URLSearchParams({ "api-version": apiVersion });
+            if (filterActivePlans)
+                params.append("filterActivePlans", "true");
+            if (includePlanDetails)
+                params.append("includePlanDetails", "true");
+            if (continuationToken)
+                params.append("continuationToken", continuationToken);
+            const url = `${connection.serverUrl}/${encodeURIComponent(project)}/_apis/testplan/Plans?${params.toString()}`;
+            const headers = {
+                Authorization: `Bearer ${accessToken}`,
+            };
+            const userAgent = userAgentProvider?.();
+            if (userAgent) {
+                headers["User-Agent"] = userAgent;
+            }
+            const response = await fetch(url, {
+                method: "GET",
+                headers,
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                throw new Error(`Failed to list test plans (${response.status}): ${errorText}`);
+            }
+            const body = await response.json();
+            const testPlans = body.value ?? [];
+            const nextToken = response.headers.get("x-ms-continuationtoken") ?? undefined;
+            const result = {
+                testPlans: testPlans,
+            };
+            if (nextToken) {
+                result.continuationToken = nextToken;
+            }
             return {
-                content: [{ type: "text", text: JSON.stringify(testPlans, null, 2) }],
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
             };
         }
         catch (error) {
@@ -258,13 +288,41 @@ function configureTestPlanTools(server, _, connectionProvider) {
         project: z.string().describe("The unique identifier (ID or name) of the Azure DevOps project."),
         planid: z.coerce.number().min(1).describe("The ID of the test plan."),
         suiteid: z.coerce.number().min(1).describe("The ID of the test suite."),
-    }, async ({ project, planid, suiteid }) => {
+        continuationToken: z.string().optional().describe("Token to continue fetching test cases from a previous request."),
+    }, async ({ project, planid, suiteid, continuationToken }) => {
         try {
             const connection = await connectionProvider();
-            const coreApi = await connection.getTestPlanApi();
-            const testcases = await coreApi.getTestCaseList(project, planid, suiteid);
+            const accessToken = await tokenProvider();
+            const params = new URLSearchParams({ "api-version": "7.2-preview.3" });
+            if (continuationToken)
+                params.append("continuationToken", continuationToken);
+            const url = `${connection.serverUrl}/${encodeURIComponent(project)}/_apis/testplan/Plans/${planid}/Suites/${suiteid}/TestCase?${params.toString()}`;
+            const headers = {
+                Authorization: `Bearer ${accessToken}`,
+            };
+            const userAgent = userAgentProvider?.();
+            if (userAgent) {
+                headers["User-Agent"] = userAgent;
+            }
+            const response = await fetch(url, {
+                method: "GET",
+                headers,
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                throw new Error(`Failed to list test cases (${response.status}): ${errorText}`);
+            }
+            const body = await response.json();
+            const testcases = body.value ?? [];
+            const nextToken = response.headers.get("x-ms-continuationtoken") ?? undefined;
+            const result = {
+                testCases: testcases,
+            };
+            if (nextToken) {
+                result.continuationToken = nextToken;
+            }
             return {
-                content: [{ type: "text", text: JSON.stringify(testcases, null, 2) }],
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
             };
         }
         catch (error) {
@@ -334,9 +392,29 @@ function configureTestPlanTools(server, _, connectionProvider) {
     }, async ({ project, planId, continuationToken }) => {
         try {
             const connection = await connectionProvider();
-            const testPlanApi = await connection.getTestPlanApi();
-            const expand = SuiteExpand.Children;
-            const testSuites = await testPlanApi.getTestSuitesForPlan(project, planId, expand, continuationToken);
+            const accessToken = await tokenProvider();
+            const params = new URLSearchParams({ "api-version": apiVersion, "expand": "children" });
+            if (continuationToken)
+                params.append("continuationToken", continuationToken);
+            const url = `${connection.serverUrl}/${encodeURIComponent(project)}/_apis/testplan/Plans/${planId}/Suites?${params.toString()}`;
+            const headers = {
+                Authorization: `Bearer ${accessToken}`,
+            };
+            const userAgent = userAgentProvider?.();
+            if (userAgent) {
+                headers["User-Agent"] = userAgent;
+            }
+            const response = await fetch(url, {
+                method: "GET",
+                headers,
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                throw new Error(`Failed to list test suites (${response.status}): ${errorText}`);
+            }
+            const body = await response.json();
+            const testSuites = body.value ?? [];
+            const nextToken = response.headers.get("x-ms-continuationtoken") ?? undefined;
             // The API returns a flat list where the root suite is first, followed by all nested suites
             // We need to build a proper hierarchy by creating a map and assembling the tree
             // Create a map of all suites by ID for quick lookup
@@ -373,7 +451,13 @@ function configureTestPlanTools(server, _, connectionProvider) {
                 }
                 return cleaned;
             };
-            const result = roots.map((root) => cleanSuite(root));
+            const cleanedSuites = roots.map((root) => cleanSuite(root));
+            const result = {
+                testSuites: cleanedSuites,
+            };
+            if (nextToken) {
+                result.continuationToken = nextToken;
+            }
             return {
                 content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
             };

package/dist/tools/work-items.js

@@ -4,6 +4,8 @@ import { WorkItemExpand } from "azure-devops-node-api/interfaces/WorkItemTrackin
 import { QueryExpand } from "azure-devops-node-api/interfaces/WorkItemTrackingInterfaces.js";
 import { z } from "zod";
 import { batchApiVersion, markdownCommentsApiVersion, getEnumKeys, safeEnumConvert, encodeFormattedValue } from "../utils.js";
+import { elicitProject } from "../shared/elicitations.js";
+import { createExternalContentResponse } from "../shared/content-safety.js";
 const WORKITEM_TOOLS = {
     my_work_items: "wit_my_work_items",
     list_backlogs: "wit_list_backlogs",
@@ -27,6 +29,7 @@ const WORKITEM_TOOLS = {
     work_item_unlink: "wit_work_item_unlink",
     add_artifact_link: "wit_add_artifact_link",
     get_work_item_attachment: "wit_get_work_item_attachment",
+    query_by_wiql: "wit_query_by_wiql",
 };
 function getLinkTypeFromName(name) {
     switch (name.toLowerCase()) {
@@ -1034,6 +1037,35 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider, userA
             };
         }
     });
+    server.tool(WORKITEM_TOOLS.query_by_wiql, "Execute a WIQL (Work Item Query Language) query and return the matching work items. If a project is not specified, you will be prompted to select one.", {
+        wiql: z.string().max(32768).describe('The WIQL query string to execute, e.g., "SELECT [System.Id], [System.Title] FROM WorkItems WHERE [System.TeamProject] = @project"'),
+        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. If not provided, the default team context will be used."),
+        timePrecision: z.boolean().optional().describe("Whether to include time precision in date fields. Defaults to false."),
+        top: z.coerce.number().default(50).describe("The maximum number of results to return. Defaults to 50."),
+    }, async ({ wiql, project, team, timePrecision, top }) => {
+        try {
+            const connection = await connectionProvider();
+            let resolvedProject = project;
+            if (!resolvedProject) {
+                const result = await elicitProject(server, connection, "Select the Azure DevOps project to run the WIQL query against.");
+                if ("response" in result)
+                    return result.response;
+                resolvedProject = result.resolved;
+            }
+            const workItemApi = await connection.getWorkItemTrackingApi();
+            const teamContext = { project: resolvedProject, team };
+            const queryResult = await workItemApi.queryByWiql({ query: wiql }, teamContext, timePrecision, top);
+            return createExternalContentResponse(queryResult, "wiql query results");
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : "Unknown error occurred";
+            return {
+                content: [{ type: "text", text: `Error executing WIQL query: ${errorMessage}` }],
+                isError: true,
+            };
+        }
+    });
     server.tool(WORKITEM_TOOLS.get_work_item_attachment, "Download a work item attachment by its ID and return the content as a base64-encoded resource. Useful for viewing images (e.g. screenshots) attached to work items such as bugs.", {
         project: z.string().describe("The name or ID of the Azure DevOps project."),
         attachmentId: z.string().describe("The GUID of the attachment. Found in the attachment URL: https://dev.azure.com/{org}/{project}/_apis/wit/attachments/{attachmentId}"),

package/dist/tools.js

@@ -24,7 +24,7 @@ function configureAllTools(server, tokenProvider, connectionProvider, userAgentP
     configureIfDomainEnabled(Domain.REPOSITORIES, () => configureRepoTools(server, tokenProvider, connectionProvider, userAgentProvider));
     configureIfDomainEnabled(Domain.WORK_ITEMS, () => configureWorkItemTools(server, tokenProvider, connectionProvider, userAgentProvider));
     configureIfDomainEnabled(Domain.WIKI, () => configureWikiTools(server, tokenProvider, connectionProvider, userAgentProvider));
-    configureIfDomainEnabled(Domain.TEST_PLANS, () => configureTestPlanTools(server, tokenProvider, connectionProvider));
+    configureIfDomainEnabled(Domain.TEST_PLANS, () => configureTestPlanTools(server, tokenProvider, connectionProvider, userAgentProvider));
     configureIfDomainEnabled(Domain.SEARCH, () => configureSearchTools(server, tokenProvider, connectionProvider, userAgentProvider));
     configureIfDomainEnabled(Domain.ADVANCED_SECURITY, () => configureAdvSecTools(server, tokenProvider, connectionProvider));
 }

package/dist/version.js

@@ -1 +1 @@
-export const packageVersion = "2.5.0-nightly.20260407";
+export const packageVersion = "2.5.0-nightly.20260409";

package/package.json

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