@azure-devops/mcp 2.9.0-nightly.20260729 → 2.9.0-nightly.20260731

package/README.md

@@ -1,14 +1,19 @@
 # ⭐ Azure DevOps MCP Server
 
-> [!IMPORTANT]
-> We recommend using the [Remote MCP Server](https://learn.microsoft.com/en-us/azure/devops/mcp-server/remote-mcp-server) instead of this local server. It requires no installation and gets new features first.
+> [!WARNING]
+> We recently completed a full tool consolidation that includes renaming of existing tools. Please see the [Toolset documentation](docs/TOOLSET.md) for the complete list of new tool names.
 >
-> [Learn more](#-remote-mcp-server-recommended)
+> If this is a breaking change for your agents or skills, you can temporarily pin the version to `@azure-devops/mcp@2.8.1`
 
 This project provides Azure DevOps MCP tooling for AI agents, with a **remote-first** onboarding experience and a local server option when you need it.
 
 ## 📄 Table of Contents
 
+> [!IMPORTANT]
+> We recommend using the [Remote MCP Server](https://learn.microsoft.com/en-us/azure/devops/mcp-server/remote-mcp-server) instead of this local server. It requires no installation and gets new features first.
+>
+> [Learn more](#-remote-mcp-server-recommended)
+
 1. [📺 Overview](#-overview)
 2. [🏆 Expectations](#-expectations)
 3. [🚀 Remote MCP Server (Recommended)](#-remote-mcp-server-recommended)

package/dist/tools/work-items.js

@@ -43,6 +43,8 @@ function getLinkTypeFromName(name) {
             return "Microsoft.VSTS.Common.Affects-Reverse";
         case "artifact":
             return "ArtifactLink";
+        case "hyperlink":
+            return "Hyperlink";
         default:
             throw new Error(`Unknown link type: ${name}`);
     }
@@ -729,9 +731,10 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider, userA
         updates: z
             .array(z.object({
             id: z.coerce.number().min(1).describe("The ID of the work item to update."),
-            linkToId: z.coerce.number().min(1).describe("The ID of the work item to link to."),
+            linkToId: z.coerce.number().min(1).optional().describe("The ID of the work item to link to. Required unless type is 'hyperlink'."),
+            url: z.string().optional().describe("The URL for a hyperlink. Required when type is 'hyperlink'."),
             type: z
-                .enum(["parent", "child", "duplicate", "duplicate of", "related", "successor", "predecessor", "tested by", "tests", "affects", "affected by"])
+                .enum(["parent", "child", "duplicate", "duplicate of", "related", "successor", "predecessor", "tested by", "tests", "affects", "affected by", "hyperlink"])
                 .default("related")
                 .describe("Type of link. Defaults to 'related'."),
             comment: z.string().optional().describe("Optional comment for the link."),
@@ -741,7 +744,7 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider, userA
         // unlink
         id: z.coerce.number().min(1).optional().describe("Work item ID to remove links from. Required for: unlink."),
         type: z
-            .enum(["parent", "child", "duplicate", "duplicate of", "related", "successor", "predecessor", "tested by", "tests", "affects", "affected by", "artifact"])
+            .enum(["parent", "child", "duplicate", "duplicate of", "related", "successor", "predecessor", "tested by", "tests", "affects", "affected by", "artifact", "hyperlink"])
             .optional()
             .describe("Link type to remove. Required for: unlink."),
         url: z.string().optional().describe("URL to match when removing a link. Used for: unlink. If not provided, all links of the specified type are removed."),
@@ -801,15 +804,23 @@ function configureWorkItemTools(server, tokenProvider, connectionProvider, userA
                     headers: { "Content-Type": "application/json-patch+json" },
                     body: updates
                         .filter((update) => update.id === uid)
-                        .map(({ linkToId, type: linkTypeName, comment: linkComment }) => ({
-                        op: "add",
-                        path: "/relations/-",
-                        value: {
-                            rel: `${getLinkTypeFromName(linkTypeName)}`,
-                            url: `${orgUrl}/${resolvedProject}/_apis/wit/workItems/${linkToId}`,
-                            attributes: { comment: linkComment || "" },
-                        },
-                    })),
+                        .map(({ linkToId, url: linkUrl, type: linkTypeName, comment: linkComment }) => {
+                        if (linkTypeName === "hyperlink" && !linkUrl) {
+                            throw new Error("url is required for hyperlink links");
+                        }
+                        if (linkTypeName !== "hyperlink" && !linkToId) {
+                            throw new Error("linkToId is required for work item links");
+                        }
+                        return {
+                            op: "add",
+                            path: "/relations/-",
+                            value: {
+                                rel: getLinkTypeFromName(linkTypeName),
+                                url: linkTypeName === "hyperlink" ? linkUrl : `${orgUrl}/${resolvedProject}/_apis/wit/workItems/${linkToId}`,
+                                attributes: { comment: linkComment || "" },
+                            },
+                        };
+                    }),
                 }));
                 const response = await fetch(`${orgUrl}/_apis/wit/$batch?api-version=${batchApiVersion}`, {
                     method: "PATCH",

package/dist/version.js

@@ -1 +1 @@
-export const packageVersion = "2.9.0-nightly.20260729";
+export const packageVersion = "2.9.0-nightly.20260731";

package/package.json

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