@azure-devops/mcp 2.2.0 → 2.2.1

package/README.md

@@ -7,8 +7,6 @@ Easily install the Azure DevOps MCP Server for VS Code or VS Code Insiders:
 
 This TypeScript project provides a **local** MCP server for Azure DevOps, enabling you to perform a wide range of Azure DevOps tasks directly from your code editor.
 
-> 🚨 **Public Preview:** This project is in public preview. Tools and features may change before general availability.
-
 ## 📄 Table of Contents
 
 1. [📺 Overview](#-overview)
@@ -83,8 +81,7 @@ Interact with these Azure DevOps services:
 ### 📁 Repositories
 
 - **repo_list_repos_by_project**: Retrieve a list of repositories for a given project.
-- **repo_list_pull_requests_by_repo**: Retrieve a list of pull requests for a given repository.
-- **repo_list_pull_requests_by_project**: Retrieve a list of pull requests for a given project ID or name.
+- **repo_list_pull_requests_by_repo_or_project**: Retrieve a list of pull requests for a given repository or project.
 - **repo_list_branches_by_repo**: Retrieve a list of branches for a given repository.
 - **repo_list_my_branches_by_repo**: Retrieve a list of your branches for a given repository ID.
 - **repo_list_pull_requests_by_commits**: List pull requests associated with commits.
@@ -95,7 +92,6 @@ 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_create_branch**: Create a new branch in the repository.
-- **repo_update_pull_request_status**: Update the status of an existing pull request to active or abandoned.
 - **repo_update_pull_request**: Update various fields of an existing pull request (title, description, draft status, target branch).
 - **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.
@@ -126,6 +122,7 @@ Interact with these Azure DevOps services:
 
 - **testplan_create_test_plan**: Create a new test plan in the project.
 - **testplan_create_test_case**: Create a new test case work item.
+- **testplan_update_test_case_steps**: Update an existing test case work item's steps.
 - **testplan_add_test_cases_to_suite**: Add existing test cases to a test suite.
 - **testplan_list_test_plans**: Retrieve a paginated list of test plans from an Azure DevOps project. Allows filtering for active plans and toggling detailed information.
 - **testplan_list_test_cases**: Get a list of test cases in the test plan.
@@ -137,6 +134,7 @@ Interact with these Azure DevOps services:
 - **wiki_list_wikis**: Retrieve a list of wikis for an organization or project.
 - **wiki_get_wiki**: Get the wiki by wikiIdentifier.
 - **wiki_list_pages**: Retrieve a list of wiki pages for a specific wiki and project.
+- **wiki_get_page**: Retrieve wiki page metadata by path.
 - **wiki_get_page_content**: Retrieve wiki page content by wikiIdentifier and path.
 - **wiki_create_or_update_page**: Create or update wiki pages with full content support.
 

package/dist/auth.js

@@ -5,14 +5,19 @@ const scopes = ["499b84ac-1321-427f-aa17-267ca6975798/.default"];
 class OAuthAuthenticator {
     static clientId = "0d50963b-7bb9-4fe7-94c7-a99af00b5136";
     static defaultAuthority = "https://login.microsoftonline.com/common";
+    static zeroTenantId = "00000000-0000-0000-0000-000000000000";
     accountId;
     publicClientApp;
     constructor(tenantId) {
         this.accountId = null;
+        let authority = OAuthAuthenticator.defaultAuthority;
+        if (tenantId && tenantId !== OAuthAuthenticator.zeroTenantId) {
+            authority = `https://login.microsoftonline.com/${tenantId}`;
+        }
         this.publicClientApp = new PublicClientApplication({
             auth: {
                 clientId: OAuthAuthenticator.clientId,
-                authority: tenantId ? `https://login.microsoftonline.com/${tenantId}` : OAuthAuthenticator.defaultAuthority,
+                authority,
             },
         });
     }

package/dist/index.js

@@ -8,7 +8,7 @@ import yargs from "yargs";
 import { hideBin } from "yargs/helpers";
 import { createAuthenticator } from "./auth.js";
 import { getOrgTenant } from "./org-tenants.js";
-import { configurePrompts } from "./prompts.js";
+//import { configurePrompts } from "./prompts.js";
 import { configureAllTools } from "./tools.js";
 import { UserAgentComposer } from "./useragent.js";
 import { packageVersion } from "./version.js";
@@ -77,7 +77,8 @@ async function main() {
     };
     const tenantId = (await getOrgTenant(orgName)) ?? argv.tenant;
     const authenticator = createAuthenticator(argv.authentication, tenantId);
-    configurePrompts(server);
+    // removing prompts untill further notice
+    // configurePrompts(server);
     configureAllTools(server, authenticator, getAzureDevOpsClient(authenticator, userAgentComposer), () => userAgentComposer.userAgent, enabledDomains);
     const transport = new StdioServerTransport();
     await server.connect(transport);

package/dist/prompts.js

@@ -1,8 +1,6 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT License.
-import { z } from "zod";
 import { CORE_TOOLS } from "./tools/core.js";
-import { WORKITEM_TOOLS } from "./tools/work-items.js";
 function configurePrompts(server) {
     server.prompt("Projects", "Lists all projects in the Azure DevOps organization.", {}, () => ({
         messages: [
@@ -18,33 +16,5 @@ Present the results in alphabetical order in a table with the following columns:
             },
         ],
     }));
-    server.prompt("Teams", "Retrieves all teams for a given Azure DevOps project.", { project: z.string() }, ({ project }) => ({
-        messages: [
-            {
-                role: "user",
-                content: {
-                    type: "text",
-                    text: String.raw `
-  # Task
-  Use the '${CORE_TOOLS.list_project_teams}' tool to retrieve all teams for the project '${project}'.
-  Present the results in alphabetical order in a table with the following columns: Name and Id`,
-                },
-            },
-        ],
-    }));
-    server.prompt("getWorkItem", "Retrieves details for a specific Azure DevOps work item by ID.", { id: z.string().describe("The ID of the work item to retrieve."), project: z.string().describe("The name or ID of the Azure DevOps project.") }, ({ id, project }) => ({
-        messages: [
-            {
-                role: "user",
-                content: {
-                    type: "text",
-                    text: String.raw `
-  # Task
-  Use the '${WORKITEM_TOOLS.get_work_item}' tool to retrieve details for the work item with ID '${id}' in project '${project}'.
-  Present the following fields: ID, Title, State, Assigned To, Work Item Type, Description or Repro Steps, and Created Date.`,
-                },
-            },
-        ],
-    }));
 }
 export { configurePrompts };

package/dist/tools/repositories.js

@@ -1,13 +1,12 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT License.
-import { PullRequestStatus, GitVersionType, GitPullRequestQueryType, CommentThreadStatus, } from "azure-devops-node-api/interfaces/GitInterfaces.js";
+import { PullRequestStatus, GitVersionType, GitPullRequestQueryType, CommentThreadStatus, GitPullRequestMergeStrategy, } from "azure-devops-node-api/interfaces/GitInterfaces.js";
 import { z } from "zod";
 import { getCurrentUserDetails, getUserIdFromEmail } from "./auth.js";
 import { getEnumKeys } from "../utils.js";
 const REPO_TOOLS = {
     list_repos_by_project: "repo_list_repos_by_project",
-    list_pull_requests_by_repo: "repo_list_pull_requests_by_repo",
-    list_pull_requests_by_project: "repo_list_pull_requests_by_project",
+    list_pull_requests_by_repo_or_project: "repo_list_pull_requests_by_repo_or_project",
     list_branches_by_repo: "repo_list_branches_by_repo",
     list_my_branches_by_repo: "repo_list_my_branches_by_repo",
     list_pull_request_threads: "repo_list_pull_request_threads",
@@ -33,6 +32,15 @@ function branchesFilterOutIrrelevantProperties(branches, top) {
         .sort((a, b) => b.localeCompare(a))
         .slice(0, top);
 }
+function trimPullRequestThread(thread) {
+    return {
+        id: thread.id,
+        publishedDate: thread.publishedDate,
+        lastUpdatedDate: thread.lastUpdatedDate,
+        status: thread.status,
+        comments: trimComments(thread.comments),
+    };
+}
 /**
  * Trims comment data to essential properties, filtering out deleted comments
  * @param comments Array of comments to trim (can be undefined/null)
@@ -74,6 +82,24 @@ function filterReposByName(repositories, repoNameFilter) {
     const filteredByName = repositories?.filter((repo) => repo.name?.toLowerCase().includes(lowerCaseFilter));
     return filteredByName;
 }
+function trimPullRequest(pr, includeDescription = false) {
+    return {
+        pullRequestId: pr.pullRequestId,
+        codeReviewId: pr.codeReviewId,
+        repository: pr.repository?.name,
+        status: pr.status,
+        createdBy: {
+            displayName: pr.createdBy?.displayName,
+            uniqueName: pr.createdBy?.uniqueName,
+        },
+        creationDate: pr.creationDate,
+        title: pr.title,
+        ...(includeDescription ? { description: pr.description ?? "" } : {}),
+        isDraft: pr.isDraft,
+        sourceRefName: pr.sourceRefName,
+        targetRefName: pr.targetRefName,
+    };
+}
 function configureRepoTools(server, tokenProvider, connectionProvider, userAgentProvider) {
     server.tool(REPO_TOOLS.create_pull_request, "Create a new pull request.", {
         repositoryId: z.string().describe("The ID of the repository where the pull request will be created."),
@@ -104,8 +130,9 @@ function configureRepoTools(server, tokenProvider, connectionProvider, userAgent
             workItemRefs: workItemRefs,
             forkSource,
         }, repositoryId);
+        const trimmedPullRequest = trimPullRequest(pullRequest, true);
         return {
-            content: [{ type: "text", text: JSON.stringify(pullRequest, null, 2) }],
+            content: [{ type: "text", text: JSON.stringify(trimmedPullRequest, null, 2) }],
         };
     });
     server.tool(REPO_TOOLS.create_branch, "Create a new branch in the repository.", {
@@ -193,7 +220,7 @@ function configureRepoTools(server, tokenProvider, connectionProvider, userAgent
             };
         }
     });
-    server.tool(REPO_TOOLS.update_pull_request, "Update a Pull Request by ID with specified fields.", {
+    server.tool(REPO_TOOLS.update_pull_request, "Update a Pull Request by ID with specified fields, including setting autocomplete with various completion options.", {
         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."),
         title: z.string().optional().describe("The new title for the pull request."),
@@ -201,7 +228,15 @@ function configureRepoTools(server, tokenProvider, connectionProvider, userAgent
         isDraft: z.boolean().optional().describe("Whether the pull request should be a draft."),
         targetRefName: z.string().optional().describe("The new target branch name (e.g., 'refs/heads/main')."),
         status: z.enum(["Active", "Abandoned"]).optional().describe("The new status of the pull request. Can be 'Active' or 'Abandoned'."),
-    }, async ({ repositoryId, pullRequestId, title, description, isDraft, targetRefName, status }) => {
+        autoComplete: z.boolean().optional().describe("Set the pull request to autocomplete when all requirements are met."),
+        mergeStrategy: z
+            .enum(getEnumKeys(GitPullRequestMergeStrategy))
+            .optional()
+            .describe("The merge strategy to use when the pull request autocompletes. Defaults to 'NoFastForward'."),
+        deleteSourceBranch: z.boolean().optional().default(false).describe("Whether to delete the source branch when the pull request autocompletes. Defaults to false."),
+        transitionWorkItems: z.boolean().optional().default(true).describe("Whether to transition associated work items to the next state when the pull request autocompletes. Defaults to true."),
+        bypassReason: z.string().optional().describe("Reason for bypassing branch policies. When provided, branch policies will be automatically bypassed during autocompletion."),
+    }, async ({ repositoryId, pullRequestId, title, description, isDraft, targetRefName, status, autoComplete, mergeStrategy, deleteSourceBranch, transitionWorkItems, bypassReason }) => {
         const connection = await connectionProvider();
         const gitApi = await connection.getGitApi();
         // Build update object with only provided fields
@@ -217,16 +252,40 @@ function configureRepoTools(server, tokenProvider, connectionProvider, userAgent
         if (status !== undefined) {
             updateRequest.status = status === "Active" ? PullRequestStatus.Active.valueOf() : PullRequestStatus.Abandoned.valueOf();
         }
+        if (autoComplete !== undefined) {
+            if (autoComplete) {
+                const data = await getCurrentUserDetails(tokenProvider, connectionProvider, userAgentProvider);
+                const autoCompleteUserId = data.authenticatedUser.id;
+                updateRequest.autoCompleteSetBy = { id: autoCompleteUserId };
+                const completionOptions = {
+                    deleteSourceBranch: deleteSourceBranch || false,
+                    transitionWorkItems: transitionWorkItems !== false, // Default to true unless explicitly set to false
+                    bypassPolicy: !!bypassReason, // Automatically set to true if bypassReason is provided
+                };
+                if (mergeStrategy) {
+                    completionOptions.mergeStrategy = GitPullRequestMergeStrategy[mergeStrategy];
+                }
+                if (bypassReason) {
+                    completionOptions.bypassReason = bypassReason;
+                }
+                updateRequest.completionOptions = completionOptions;
+            }
+            else {
+                updateRequest.autoCompleteSetBy = null;
+                updateRequest.completionOptions = null;
+            }
+        }
         // Validate that at least one field is provided for update
         if (Object.keys(updateRequest).length === 0) {
             return {
-                content: [{ type: "text", text: "Error: At least one field (title, description, isDraft, targetRefName, or status) must be provided for update." }],
+                content: [{ type: "text", text: "Error: At least one field (title, description, isDraft, targetRefName, status, or autoComplete options) must be provided for update." }],
                 isError: true,
             };
         }
         const updatedPullRequest = await gitApi.updatePullRequest(updateRequest, repositoryId, pullRequestId);
+        const trimmedUpdatedPullRequest = trimPullRequest(updatedPullRequest, true);
         return {
-            content: [{ type: "text", text: JSON.stringify(updatedPullRequest, null, 2) }],
+            content: [{ type: "text", text: JSON.stringify(trimmedUpdatedPullRequest, null, 2) }],
         };
     });
     server.tool(REPO_TOOLS.update_pull_request_reviewers, "Add or remove reviewers for an existing pull request.", {
@@ -240,8 +299,16 @@ function configureRepoTools(server, tokenProvider, connectionProvider, userAgent
         let updatedPullRequest;
         if (action === "add") {
             updatedPullRequest = await gitApi.createPullRequestReviewers(reviewerIds.map((id) => ({ id: id })), repositoryId, pullRequestId);
+            const trimmedResponse = updatedPullRequest.map((item) => ({
+                displayName: item.displayName,
+                id: item.id,
+                uniqueName: item.uniqueName,
+                vote: item.vote,
+                hasDeclined: item.hasDeclined,
+                isFlagged: item.isFlagged,
+            }));
             return {
-                content: [{ type: "text", text: JSON.stringify(updatedPullRequest, null, 2) }],
+                content: [{ type: "text", text: JSON.stringify(trimmedResponse, null, 2) }],
             };
         }
         else {
@@ -278,8 +345,9 @@ function configureRepoTools(server, tokenProvider, connectionProvider, userAgent
             content: [{ type: "text", text: JSON.stringify(trimmedRepositories, null, 2) }],
         };
     });
-    server.tool(REPO_TOOLS.list_pull_requests_by_repo, "Retrieve a list of pull requests for a given repository.", {
-        repositoryId: z.string().describe("The ID of the repository where the pull requests are located."),
+    server.tool(REPO_TOOLS.list_pull_requests_by_repo_or_project, "Retrieve a list of pull requests for a given repository. Either repositoryId or project must be provided.", {
+        repositoryId: z.string().optional().describe("The ID of the repository where the pull requests are located."),
+        project: z.string().optional().describe("The ID of the project where the pull requests are located."),
         top: z.number().default(100).describe("The maximum number of pull requests to return."),
         skip: z.number().default(0).describe("The number of pull requests to skip."),
         created_by_me: z.boolean().default(false).describe("Filter pull requests created by the current user."),
@@ -295,14 +363,27 @@ function configureRepoTools(server, tokenProvider, connectionProvider, userAgent
             .describe("Filter pull requests by status. Defaults to 'Active'."),
         sourceRefName: z.string().optional().describe("Filter pull requests from this source branch (e.g., 'refs/heads/feature-branch')."),
         targetRefName: z.string().optional().describe("Filter pull requests into this target branch (e.g., 'refs/heads/main')."),
-    }, async ({ repositoryId, top, skip, created_by_me, created_by_user, i_am_reviewer, user_is_reviewer, status, sourceRefName, targetRefName }) => {
+    }, async ({ repositoryId, project, top, skip, created_by_me, created_by_user, i_am_reviewer, user_is_reviewer, status, sourceRefName, targetRefName }) => {
         const connection = await connectionProvider();
         const gitApi = await connection.getGitApi();
         // Build the search criteria
         const searchCriteria = {
             status: pullRequestStatusStringToInt(status),
-            repositoryId: repositoryId,
         };
+        if (!repositoryId && !project) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Either repositoryId or project must be provided.",
+                    },
+                ],
+                isError: true,
+            };
+        }
+        if (repositoryId) {
+            searchCriteria.repositoryId = repositoryId;
+        }
         if (sourceRefName) {
             searchCriteria.sourceRefName = sourceRefName;
         }
@@ -353,120 +434,30 @@ function configureRepoTools(server, tokenProvider, connectionProvider, userAgent
             const userId = data.authenticatedUser.id;
             searchCriteria.reviewerId = userId;
         }
-        const pullRequests = await gitApi.getPullRequests(repositoryId, searchCriteria, undefined, // project
-        undefined, // maxCommentLength
-        skip, top);
-        // Filter out the irrelevant properties
-        const filteredPullRequests = pullRequests?.map((pr) => ({
-            pullRequestId: pr.pullRequestId,
-            codeReviewId: pr.codeReviewId,
-            status: pr.status,
-            createdBy: {
-                displayName: pr.createdBy?.displayName,
-                uniqueName: pr.createdBy?.uniqueName,
-            },
-            creationDate: pr.creationDate,
-            title: pr.title,
-            isDraft: pr.isDraft,
-            sourceRefName: pr.sourceRefName,
-            targetRefName: pr.targetRefName,
-        }));
-        return {
-            content: [{ type: "text", text: JSON.stringify(filteredPullRequests, null, 2) }],
-        };
-    });
-    server.tool(REPO_TOOLS.list_pull_requests_by_project, "Retrieve a list of pull requests for a given project Id or Name.", {
-        project: z.string().describe("The name or ID of the Azure DevOps project."),
-        top: z.number().default(100).describe("The maximum number of pull requests to return."),
-        skip: z.number().default(0).describe("The number of pull requests to skip."),
-        created_by_me: z.boolean().default(false).describe("Filter pull requests created by the current user."),
-        created_by_user: z.string().optional().describe("Filter pull requests created by a specific user (provide email or unique name). Takes precedence over created_by_me if both are provided."),
-        i_am_reviewer: z.boolean().default(false).describe("Filter pull requests where the current user is a reviewer."),
-        user_is_reviewer: z
-            .string()
-            .optional()
-            .describe("Filter pull requests where a specific user is a reviewer (provide email or unique name). Takes precedence over i_am_reviewer if both are provided."),
-        status: z
-            .enum(getEnumKeys(PullRequestStatus))
-            .default("Active")
-            .describe("Filter pull requests by status. Defaults to 'Active'."),
-        sourceRefName: z.string().optional().describe("Filter pull requests from this source branch (e.g., 'refs/heads/feature-branch')."),
-        targetRefName: z.string().optional().describe("Filter pull requests into this target branch (e.g., 'refs/heads/main')."),
-    }, async ({ project, top, skip, created_by_me, created_by_user, i_am_reviewer, user_is_reviewer, status, sourceRefName, targetRefName }) => {
-        const connection = await connectionProvider();
-        const gitApi = await connection.getGitApi();
-        // Build the search criteria
-        const gitPullRequestSearchCriteria = {
-            status: pullRequestStatusStringToInt(status),
-        };
-        if (sourceRefName) {
-            gitPullRequestSearchCriteria.sourceRefName = sourceRefName;
-        }
-        if (targetRefName) {
-            gitPullRequestSearchCriteria.targetRefName = targetRefName;
-        }
-        if (created_by_user) {
-            try {
-                const userId = await getUserIdFromEmail(created_by_user, tokenProvider, connectionProvider, userAgentProvider);
-                gitPullRequestSearchCriteria.creatorId = userId;
-            }
-            catch (error) {
-                return {
-                    content: [
-                        {
-                            type: "text",
-                            text: `Error finding user with email ${created_by_user}: ${error instanceof Error ? error.message : String(error)}`,
-                        },
-                    ],
-                    isError: true,
-                };
-            }
+        let pullRequests;
+        if (repositoryId) {
+            pullRequests = await gitApi.getPullRequests(repositoryId, searchCriteria, project, // project
+            undefined, // maxCommentLength
+            skip, top);
         }
-        else if (created_by_me) {
-            const data = await getCurrentUserDetails(tokenProvider, connectionProvider, userAgentProvider);
-            const userId = data.authenticatedUser.id;
-            gitPullRequestSearchCriteria.creatorId = userId;
+        else if (project) {
+            // If only project is provided, use getPullRequestsByProject
+            pullRequests = await gitApi.getPullRequestsByProject(project, searchCriteria, undefined, // maxCommentLength
+            skip, top);
         }
-        if (user_is_reviewer) {
-            try {
-                const reviewerUserId = await getUserIdFromEmail(user_is_reviewer, tokenProvider, connectionProvider, userAgentProvider);
-                gitPullRequestSearchCriteria.reviewerId = reviewerUserId;
-            }
-            catch (error) {
-                return {
-                    content: [
-                        {
-                            type: "text",
-                            text: `Error finding reviewer with email ${user_is_reviewer}: ${error instanceof Error ? error.message : String(error)}`,
-                        },
-                    ],
-                    isError: true,
-                };
-            }
-        }
-        else if (i_am_reviewer) {
-            const data = await getCurrentUserDetails(tokenProvider, connectionProvider, userAgentProvider);
-            const userId = data.authenticatedUser.id;
-            gitPullRequestSearchCriteria.reviewerId = userId;
+        else {
+            // This case should not occur due to earlier validation, but added for completeness
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Either repositoryId or project must be provided.",
+                    },
+                ],
+                isError: true,
+            };
         }
-        const pullRequests = await gitApi.getPullRequestsByProject(project, gitPullRequestSearchCriteria, undefined, // maxCommentLength
-        skip, top);
-        // Filter out the irrelevant properties
-        const filteredPullRequests = pullRequests?.map((pr) => ({
-            pullRequestId: pr.pullRequestId,
-            codeReviewId: pr.codeReviewId,
-            repository: pr.repository?.name,
-            status: pr.status,
-            createdBy: {
-                displayName: pr.createdBy?.displayName,
-                uniqueName: pr.createdBy?.uniqueName,
-            },
-            creationDate: pr.creationDate,
-            title: pr.title,
-            isDraft: pr.isDraft,
-            sourceRefName: pr.sourceRefName,
-            targetRefName: pr.targetRefName,
-        }));
+        const filteredPullRequests = pullRequests?.map((pr) => trimPullRequest(pr));
         return {
             content: [{ type: "text", text: JSON.stringify(filteredPullRequests, null, 2) }],
         };
@@ -491,13 +482,7 @@ function configureRepoTools(server, tokenProvider, connectionProvider, userAgent
             };
         }
         // Return trimmed thread data focusing on essential information
-        const trimmedThreads = paginatedThreads?.map((thread) => ({
-            id: thread.id,
-            publishedDate: thread.publishedDate,
-            lastUpdatedDate: thread.lastUpdatedDate,
-            status: thread.status,
-            comments: trimComments(thread.comments),
-        }));
+        const trimmedThreads = paginatedThreads?.map((thread) => trimPullRequestThread(thread));
         return {
             content: [{ type: "text", text: JSON.stringify(trimmedThreads, null, 2) }],
         };
@@ -687,8 +672,9 @@ function configureRepoTools(server, tokenProvider, connectionProvider, userAgent
             }
         }
         const thread = await gitApi.createThread({ comments: [{ content: content }], threadContext: threadContext, status: CommentThreadStatus[status] }, repositoryId, pullRequestId, project);
+        const trimmedThread = trimPullRequestThread(thread);
         return {
-            content: [{ type: "text", text: JSON.stringify(thread, null, 2) }],
+            content: [{ type: "text", text: JSON.stringify(trimmedThread, null, 2) }],
         };
     });
     server.tool(REPO_TOOLS.resolve_comment, "Resolves a specific comment thread on a pull request.", {

package/dist/tools/test-plans.js

@@ -4,6 +4,7 @@ import { z } from "zod";
 const Test_Plan_Tools = {
     create_test_plan: "testplan_create_test_plan",
     create_test_case: "testplan_create_test_case",
+    update_test_case_steps: "testplan_update_test_case_steps",
     add_test_cases_to_suite: "testplan_add_test_cases_to_suite",
     test_results_from_build_id: "testplan_show_test_results_from_build_id",
     list_test_cases: "testplan_list_test_cases",
@@ -11,10 +12,6 @@ const Test_Plan_Tools = {
     create_test_suite: "testplan_create_test_suite",
 };
 function configureTestPlanTools(server, _, connectionProvider) {
-    /*
-      LIST OF TEST PLANS
-      get list of test plans by project
-    */
     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."),
@@ -29,9 +26,6 @@ function configureTestPlanTools(server, _, connectionProvider) {
             content: [{ type: "text", text: JSON.stringify(testPlans, null, 2) }],
         };
     });
-    /*
-      Create Test Plan - CREATE
-    */
     server.tool(Test_Plan_Tools.create_test_plan, "Creates a new test plan in the project.", {
         project: z.string().describe("The unique identifier (ID or name) of the Azure DevOps project where the test plan will be created."),
         name: z.string().describe("The name of the test plan to be created."),
@@ -56,9 +50,6 @@ function configureTestPlanTools(server, _, connectionProvider) {
             content: [{ type: "text", text: JSON.stringify(createdTestPlan, null, 2) }],
         };
     });
-    /*
-      Create Test Suite - CREATE
-    */
     server.tool(Test_Plan_Tools.create_test_suite, "Creates a new test suite in a test plan.", {
         project: z.string().describe("Project ID or project name"),
         planId: z.number().describe("ID of the test plan that contains the suites"),
@@ -80,9 +71,6 @@ function configureTestPlanTools(server, _, connectionProvider) {
             content: [{ type: "text", text: JSON.stringify(createdTestSuite, null, 2) }],
         };
     });
-    /*
-      Add Test Cases to Suite - ADD
-    */
     server.tool(Test_Plan_Tools.add_test_cases_to_suite, "Adds existing test cases to a test suite.", {
         project: z.string().describe("The unique identifier (ID or name) of the Azure DevOps project."),
         planId: z.number().describe("The ID of the test plan."),
@@ -98,9 +86,6 @@ function configureTestPlanTools(server, _, connectionProvider) {
             content: [{ type: "text", text: JSON.stringify(addedTestCases, null, 2) }],
         };
     });
-    /*
-      Create Test Case - CREATE
-    */
     server.tool(Test_Plan_Tools.create_test_case, "Creates a new test case work item.", {
         project: z.string().describe("The unique identifier (ID or name) of the Azure DevOps project."),
         title: z.string().describe("The title of the test case."),
@@ -111,7 +96,8 @@ function configureTestPlanTools(server, _, connectionProvider) {
         priority: z.number().optional().describe("The priority of the test case."),
         areaPath: z.string().optional().describe("The area path for the test case."),
         iterationPath: z.string().optional().describe("The iteration path for the test case."),
-    }, async ({ project, title, steps, priority, areaPath, iterationPath }) => {
+        testsWorkItemId: z.number().optional().describe("Optional work item id that will be set as a Microsoft.VSTS.Common.TestedBy-Reverse link to the test case."),
+    }, async ({ project, title, steps, priority, areaPath, iterationPath, testsWorkItemId }) => {
         const connection = await connectionProvider();
         const witClient = await connection.getWorkItemTrackingApi();
         let stepsXml;
@@ -125,6 +111,16 @@ function configureTestPlanTools(server, _, connectionProvider) {
             path: "/fields/System.Title",
             value: title,
         });
+        if (testsWorkItemId) {
+            patchDocument.push({
+                op: "add",
+                path: "/relations/-",
+                value: {
+                    rel: "Microsoft.VSTS.Common.TestedBy-Reverse",
+                    url: `${connection.serverUrl}/${project}/_apis/wit/workItems/${testsWorkItemId}`,
+                },
+            });
+        }
         if (stepsXml) {
             patchDocument.push({
                 op: "add",
@@ -158,10 +154,32 @@ function configureTestPlanTools(server, _, connectionProvider) {
             content: [{ type: "text", text: JSON.stringify(workItem, null, 2) }],
         };
     });
-    /*
-      TEST PLANS
-      Gets a list of test cases for a given testplan.
-    */
+    server.tool(Test_Plan_Tools.update_test_case_steps, "Update an existing test case work item.", {
+        id: z.number().describe("The ID of the test case work item to update."),
+        steps: z
+            .string()
+            .describe("The steps to reproduce the test case. Make sure to format each step as '1. Step one|Expected result one\n2. Step two|Expected result two. USE '|' as the delimiter between step and expected result. DO NOT use '|' in the description of the step or expected result."),
+    }, async ({ id, steps }) => {
+        const connection = await connectionProvider();
+        const witClient = await connection.getWorkItemTrackingApi();
+        let stepsXml;
+        if (steps) {
+            stepsXml = convertStepsToXml(steps);
+        }
+        // Create JSON patch document for work item
+        const patchDocument = [];
+        if (stepsXml) {
+            patchDocument.push({
+                op: "add",
+                path: "/fields/Microsoft.VSTS.TCM.Steps",
+                value: stepsXml,
+            });
+        }
+        const workItem = await witClient.updateWorkItem({}, patchDocument, id);
+        return {
+            content: [{ type: "text", text: JSON.stringify(workItem, null, 2) }],
+        };
+    });
     server.tool(Test_Plan_Tools.list_test_cases, "Gets a list of test cases in the test plan.", {
         project: z.string().describe("The unique identifier (ID or name) of the Azure DevOps project."),
         planid: z.number().describe("The ID of the test plan."),
@@ -174,9 +192,6 @@ function configureTestPlanTools(server, _, connectionProvider) {
             content: [{ type: "text", text: JSON.stringify(testcases, null, 2) }],
         };
     });
-    /*
-      Gets a list of test results for a given project and build ID
-    */
     server.tool(Test_Plan_Tools.test_results_from_build_id, "Gets a list of test results for a given project and build ID.", {
         project: z.string().describe("The unique identifier (ID or name) of the Azure DevOps project."),
         buildid: z.number().describe("The ID of the build."),

package/dist/version.js

@@ -1 +1 @@
-export const packageVersion = "2.2.0";
+export const packageVersion = "2.2.1";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@azure-devops/mcp",
-  "version": "2.2.0",
+  "version": "2.2.1",
   "description": "MCP server for interacting with Azure DevOps",
   "license": "MIT",
   "author": "Microsoft Corporation",
@@ -38,7 +38,7 @@
   },
   "dependencies": {
     "@azure/identity": "^4.10.0",
-    "@modelcontextprotocol/sdk": "1.17.0",
+    "@modelcontextprotocol/sdk": "1.20.0",
     "azure-devops-extension-api": "^4.252.0",
     "azure-devops-extension-sdk": "^4.0.2",
     "azure-devops-node-api": "^15.1.0",
@@ -47,7 +47,7 @@
     "zod-to-json-schema": "^3.24.5"
   },
   "devDependencies": {
-    "@modelcontextprotocol/inspector": "^0.16.1",
+    "@modelcontextprotocol/inspector": "^0.17.0",
     "@types/jest": "^30.0.0",
     "@types/node": "^22",
     "eslint-config-prettier": "10.1.8",
@@ -59,7 +59,7 @@
     "shx": "^0.4.0",
     "ts-jest": "^29.4.0",
     "tsconfig-paths": "^4.2.0",
-    "typescript": "^5.8.3",
-    "typescript-eslint": "^8.32.1"
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.45.0"
   }
 }