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

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/version.js

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

package/package.json

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