@azure-devops/mcp 1.1.0 → 1.2.0-daily.20250715

package/README.md

@@ -47,6 +47,7 @@ Interact with these Azure DevOps services:
 
 - **core_list_project_teams**: Retrieve a list of teams for the specified Azure DevOps project.
 - **core_list_projects**: Retrieve a list of projects in your Azure DevOps organization.
+- **core_get_identity_ids**: Retrieve Azure DevOps identity IDs for a list of unique names.
 
 ### ⚒️ Work
 
@@ -94,6 +95,7 @@ Interact with these Azure DevOps services:
 - **repo_get_pull_request_by_id**: Get a pull request by its ID.
 - **repo_create_pull_request**: Create a new pull request.
 - **repo_update_pull_request_status**: Update status of an existing pull request to active or abandoned.
+- **repo_update_pull_request_reviewers**: Add or remove reviewers for an existing pull request.
 - **repo_reply_to_comment**: Replies to a specific comment on a pull request.
 - **repo_resolve_comment**: Resolves a specific comment thread on a pull request.
 - **repo_search_commits**: Searches for commits.

package/dist/index.js

@@ -17,7 +17,12 @@ if (args.length === 0) {
 export const orgName = args[0];
 const orgUrl = "https://dev.azure.com/" + orgName;
 async function getAzureDevOpsToken() {
-    process.env.AZURE_TOKEN_CREDENTIALS = "dev";
+    if (process.env.ADO_MCP_AZURE_TOKEN_CREDENTIALS) {
+        process.env.AZURE_TOKEN_CREDENTIALS = process.env.ADO_MCP_AZURE_TOKEN_CREDENTIALS;
+    }
+    else {
+        process.env.AZURE_TOKEN_CREDENTIALS = "dev";
+    }
     const credential = new DefaultAzureCredential(); // CodeQL [SM05138] resolved by explicitly setting AZURE_TOKEN_CREDENTIALS
     const token = await credential.getToken("499b84ac-1321-427f-aa17-267ca6975798/.default");
     return token;

package/dist/tools/core.js

@@ -1,9 +1,11 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT License.
 import { z } from "zod";
+import { apiVersion } from "../utils.js";
 const CORE_TOOLS = {
     list_project_teams: "core_list_project_teams",
     list_projects: "core_list_projects",
+    get_identity_ids: "core_get_identity_ids",
 };
 function filterProjectsByName(projects, projectNameFilter) {
     const lowerCaseFilter = projectNameFilter.toLowerCase();
@@ -62,5 +64,51 @@ function configureCoreTools(server, tokenProvider, connectionProvider) {
             };
         }
     });
+    server.tool(CORE_TOOLS.get_identity_ids, "Retrieve Azure DevOps identity IDs for a provided search filter.", {
+        searchFilter: z.string().describe("Search filter (unique namme, display name, email) to retrieve identity IDs for."),
+    }, async ({ searchFilter }) => {
+        try {
+            const token = await tokenProvider();
+            const connection = await connectionProvider();
+            const orgName = connection.serverUrl.split("/")[3];
+            const baseUrl = `https://vssps.dev.azure.com/${orgName}/_apis/identities`;
+            const params = new URLSearchParams({
+                "api-version": apiVersion,
+                "searchFilter": "General",
+                "filterValue": searchFilter,
+            });
+            const response = await fetch(`${baseUrl}?${params}`, {
+                headers: {
+                    "Authorization": `Bearer ${token.token}`,
+                    "Content-Type": "application/json",
+                },
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                throw new Error(`HTTP ${response.status}: ${errorText}`);
+            }
+            const identities = await response.json();
+            if (!identities || identities.value?.length === 0) {
+                return { content: [{ type: "text", text: "No identities found" }], isError: true };
+            }
+            const identitiesTrimmed = identities.value?.map((identity) => {
+                return {
+                    id: identity.id,
+                    displayName: identity.providerDisplayName,
+                    descriptor: identity.descriptor,
+                };
+            });
+            return {
+                content: [{ type: "text", text: JSON.stringify(identitiesTrimmed, null, 2) }],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : "Unknown error occurred";
+            return {
+                content: [{ type: "text", text: `Error fetching identities: ${errorMessage}` }],
+                isError: true,
+            };
+        }
+    });
 }
 export { CORE_TOOLS, configureCoreTools };

package/dist/tools/repos.js

@@ -16,6 +16,7 @@ const REPO_TOOLS = {
     get_pull_request_by_id: "repo_get_pull_request_by_id",
     create_pull_request: "repo_create_pull_request",
     update_pull_request_status: "repo_update_pull_request_status",
+    update_pull_request_reviewers: "repo_update_pull_request_reviewers",
     reply_to_comment: "repo_reply_to_comment",
     resolve_comment: "repo_resolve_comment",
     search_commits: "repo_search_commits",
@@ -88,6 +89,30 @@ function configureRepoTools(server, tokenProvider, connectionProvider) {
             content: [{ type: "text", text: JSON.stringify(updatedPullRequest, null, 2) }],
         };
     });
+    server.tool(REPO_TOOLS.update_pull_request_reviewers, "Add or remove reviewers for an existing pull request.", {
+        repositoryId: z.string().describe("The ID of the repository where the pull request exists."),
+        pullRequestId: z.number().describe("The ID of the pull request to update."),
+        reviewerIds: z.array(z.string()).describe("List of reviewer ids to add or remove from the pull request."),
+        action: z.enum(["add", "remove"]).describe("Action to perform on the reviewers. Can be 'add' or 'remove'."),
+    }, async ({ repositoryId, pullRequestId, reviewerIds, action }) => {
+        const connection = await connectionProvider();
+        const gitApi = await connection.getGitApi();
+        let updatedPullRequest;
+        if (action === "add") {
+            updatedPullRequest = await gitApi.createPullRequestReviewers(reviewerIds.map((id) => ({ id: id })), repositoryId, pullRequestId);
+            return {
+                content: [{ type: "text", text: JSON.stringify(updatedPullRequest, null, 2) }],
+            };
+        }
+        else {
+            for (const reviewerId of reviewerIds) {
+                await gitApi.deletePullRequestReviewer(repositoryId, pullRequestId, reviewerId);
+            }
+            return {
+                content: [{ type: "text", text: `Reviewers with IDs ${reviewerIds.join(", ")} removed from pull request ${pullRequestId}.` }],
+            };
+        }
+    });
     server.tool(REPO_TOOLS.list_repos_by_project, "Retrieve a list of repositories for a given project", {
         project: z.string().describe("The name or ID of the Azure DevOps project."),
         top: z.number().default(100).describe("The maximum number of repositories to return."),

package/dist/useragent.js

@@ -1,3 +1,5 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
 class UserAgentComposer {
     _userAgent;
     _mcpClientInfoAppended;

package/dist/version.js

@@ -1 +1 @@
-export const packageVersion = "1.1.0";
+export const packageVersion = "1.2.0-daily.20250715";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@azure-devops/mcp",
-  "version": "1.1.0",
+  "version": "1.2.0-daily.20250715",
   "description": "MCP server for interacting with Azure DevOps",
   "license": "MIT",
   "author": "Microsoft Corporation",