@azure-devops/mcp 2.8.0-nightly.20260707 → 2.8.0-nightly.20260710

package/dist/tools/test-plans.js

@@ -474,6 +474,22 @@ function configureTestPlanTools(server, tokenProvider, connectionProvider, userA
         }
     });
 }
+/*
+ * Format step content by converting Markdown markers to HTML and wrapping in the ADO rich text
+ * envelope. The entire HTML string is then XML-escaped for storage in the parameterizedString
+ * element, which is the format Azure DevOps expects for rendered step content.
+ */
+function formatStepContent(text) {
+    // Convert Markdown markers to HTML tags (** before * and __ before _ to avoid conflicts)
+    const htmlContent = text
+        .replace(/\*\*(.+?)\*\*/g, "<b>$1</b>")
+        .replace(/\*(.+?)\*/g, "<i>$1</i>")
+        .replace(/__(.+?)__/g, "<u>$1</u>")
+        .replace(/`(.+?)`/g, "<code>$1</code>")
+        .replace(/\[([^\]]+)\]\((https?:\/\/[^)]+)\)/g, '<a href="$2">$1</a>');
+    // Wrap in ADO rich text envelope and XML-escape the entire HTML string
+    return escapeXml(`${htmlContent}`);
+}
 /*
  * Helper function to convert steps text to XML format required
  */
@@ -491,8 +507,8 @@ function convertStepsToXml(steps) {
             const expectedText = expectedPart || "Verify step completes successfully";
             xmlSteps += `
                 <step id="${i + 1}" type="ActionStep">
-                    <parameterizedString isformatted="true">${escapeXml(stepText)}</parameterizedString>
-                    <parameterizedString isformatted="true">${escapeXml(expectedText)}</parameterizedString>
+                    <parameterizedString isformatted="true">${formatStepContent(stepText)}</parameterizedString>
+                    <parameterizedString isformatted="true">${formatStepContent(expectedText)}</parameterizedString>
                 </step>`;
         }
     }

package/dist/tools/work-items.js

@@ -63,6 +63,14 @@ function getLinkTypeFromName(name) {
             throw new Error(`Unknown link type: ${name}`);
     }
 }
+function getArtifactLinkAttributeName(linkType) {
+    switch (linkType) {
+        case "Wiki":
+            return "Wiki Page";
+        default:
+            return linkType;
+    }
+}
 function configureWorkItemTools(server, tokenProvider, connectionProvider, userAgentProvider) {
     server.tool(WORKITEM_TOOLS.list_backlogs, "Receive a list of backlogs for a given project and 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."),
@@ -1057,6 +1065,16 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider, userA
         commitId: z.string().optional().describe("The commit SHA hash. Required when linkType is 'Fixed in Commit'."),
         pullRequestId: z.coerce.number().min(1).optional().describe("The pull request ID. Required when linkType is 'Pull Request'."),
         buildId: z.coerce.number().min(1).optional().describe("The build ID. Required when linkType is 'Build', 'Found in build', or 'Integrated in build'."),
+        wikiId: z.string().optional().describe("The wiki ID (GUID). Required when linkType is 'Wiki'."),
+        pageId: z.coerce
+            .number()
+            .min(1)
+            .optional()
+            .describe("The numeric wiki page ID from the browser URL (e.g., '98' in '.../wikis/Contoso.wiki/98/What-is-Contoso'). When provided for 'Wiki' links, the full page path is resolved automatically via the API. Takes precedence over 'pagePath'."),
+        pagePath: z
+            .string()
+            .optional()
+            .describe("The full wiki page path from the wiki root (e.g., '/Home/What-is-Contoso'). Required when linkType is 'Wiki' and 'pageId' is not provided. Must be the complete path, not just the page name from the URL."),
         linkType: z
             .enum([
             "Branch",
@@ -1077,7 +1095,7 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider, userA
             .default("Branch")
             .describe("Type of artifact link, defaults to 'Branch'. This determines both the link type and how to build the VSTFS URI from individual components."),
         comment: z.string().optional().describe("Comment to include with the artifact link."),
-    }, async ({ workItemId, project, artifactUri, projectId, repositoryId, branchName, commitId, pullRequestId, buildId, linkType, comment }) => {
+    }, async ({ workItemId, project, artifactUri, projectId, repositoryId, branchName, commitId, pullRequestId, buildId, wikiId, pageId, pagePath, linkType, comment }) => {
         try {
             const connection = await connectionProvider();
             let resolvedProject = project;
@@ -1134,6 +1152,45 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider, userA
                         }
                         finalArtifactUri = `vstfs:///Build/Build/${encodeURIComponent(buildId.toString())}`;
                         break;
+                    case "Wiki": {
+                        if (!projectId || !wikiId) {
+                            return {
+                                content: [{ type: "text", text: "For 'Wiki' links, 'projectId', 'wikiId', and 'pagePath' are required." }],
+                                isError: true,
+                            };
+                        }
+                        let resolvedPagePath = pagePath;
+                        if (pageId !== undefined) {
+                            // Look up the actual page path by page ID to get the full path
+                            const orgUrl = connection.serverUrl;
+                            const accessToken = await tokenProvider();
+                            const pageResponse = await fetch(`${orgUrl}/${encodeURIComponent(resolvedProject)}/_apis/wiki/wikis/${encodeURIComponent(wikiId)}/pages/${pageId}?api-version=7.1`, {
+                                headers: {
+                                    "Authorization": `Bearer ${accessToken}`,
+                                    "User-Agent": userAgentProvider(),
+                                },
+                            });
+                            if (!pageResponse.ok) {
+                                return {
+                                    content: [{ type: "text", text: `Failed to look up wiki page ID ${pageId}: ${pageResponse.statusText}` }],
+                                    isError: true,
+                                };
+                            }
+                            const pageData = await pageResponse.json();
+                            resolvedPagePath = pageData.path;
+                        }
+                        if (!resolvedPagePath) {
+                            return {
+                                content: [{ type: "text", text: "For 'Wiki' links, 'pageId' or 'pagePath' is required." }],
+                                isError: true,
+                            };
+                        }
+                        // Strip leading slash, then encode each segment joined by %2F
+                        const normalizedPath = resolvedPagePath.startsWith("/") ? resolvedPagePath.slice(1) : resolvedPagePath;
+                        const encodedPath = normalizedPath.split("/").map(encodeURIComponent).join("%2F");
+                        finalArtifactUri = `vstfs:///Wiki/WikiPage/${encodeURIComponent(projectId)}%2F${encodeURIComponent(wikiId)}%2F${encodedPath}`;
+                        break;
+                    }
                     default:
                         return {
                             content: [{ type: "text", text: `URI building from components is not supported for link type '${linkType}'. Please provide the full 'artifactUri' instead.` }],
@@ -1150,7 +1207,7 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider, userA
                         rel: "ArtifactLink",
                         url: finalArtifactUri,
                         attributes: {
-                            name: linkType,
+                            name: getArtifactLinkAttributeName(linkType),
                             ...(comment && { comment }),
                         },
                     },

package/dist/version.js

@@ -1 +1 @@
-export const packageVersion = "2.8.0-nightly.20260707";
+export const packageVersion = "2.8.0-nightly.20260710";

package/package.json

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