@azure-devops/mcp 2.0.0 → 2.1.0-nightly.20250910

package/README.md

@@ -15,10 +15,11 @@ This TypeScript project provides a **local** MCP server for Azure DevOps, enabli
 2. [🏆 Expectations](#-expectations)
 3. [⚙️ Supported Tools](#️-supported-tools)
 4. [🔌 Installation & Getting Started](#-installation--getting-started)
-5. [📝 Troubleshooting](#-troubleshooting)
-6. [🎩 Examples & Best Practices](#-examples--best-practices)
-7. [🙋‍♀️ Frequently Asked Questions](#️-frequently-asked-questions)
-8. [📌 Contributing](#-contributing)
+5. [🌏 Using Domains](#-using-domains)
+6. [📝 Troubleshooting](#-troubleshooting)
+7. [🎩 Examples & Best Practices](#-examples--best-practices)
+8. [🙋‍♀️ Frequently Asked Questions](#️-frequently-asked-questions)
+9. [📌 Contributing](#-contributing)
 
 ## 📺 Overview
 
@@ -26,7 +27,6 @@ The Azure DevOps MCP Server brings Azure DevOps context to your agents. Try prom
 
 - "List my ADO projects"
 - "List ADO Builds for 'Contoso'"
-- "List ADO Releases for 'Contoso'"
 - "List ADO Repos for 'Contoso'"
 - "List test plans for 'Contoso'"
 - "List teams for project 'Contoso'"
@@ -102,24 +102,21 @@ Interact with these Azure DevOps services:
 - **repo_search_commits**: Searches for commits.
 - **repo_create_pull_request_thread**: Creates a new comment thread on a pull request.
 
-### 🛰️ Builds
+### 🚀 Pipelines
 
-- **build_get_definitions**: Retrieve a list of build definitions for a given project.
-- **build_get_definition_revisions**: Retrieve a list of revisions for a specific build definition.
-- **build_get_builds**: Retrieve a list of builds for a given project.
-- **build_get_log**: Retrieve the logs for a specific build.
-- **build_get_log_by_id**: Get a specific build log by log ID.
-- **build_get_changes**: Get the changes associated with a specific build.
-- **build_run_build**: Trigger a new build for a specified definition.
-- **build_get_status**: Fetch the status of a specific build.
-- **build_update_build_stage**: Update the stage of a specific build.
+- **pipelines_get_build_definitions**: Retrieve a list of build definitions for a given project.
+- **pipelines_get_build_definition_revisions**: Retrieve a list of revisions for a specific build definition.
+- **pipelines_get_builds**: Retrieve a list of builds for a given project.
+- **pipelines_get_build_log**: Retrieve the logs for a specific build.
+- **pipelines_get_build_log_by_id**: Get a specific build log by log ID.
+- **pipelines_get_build_changes**: Get the changes associated with a specific build.
+- **pipelines_get_build_status**: Fetch the status of a specific build.
+- **pipelines_update_build_stage**: Update the stage of a specific build.
+- **pipelines_get_run**: Gets a run for a particular pipeline.
+- **pipelines_list_runs**: Gets top 10000 runs for a particular pipeline.
+- **pipelines_run_pipeline**: Starts a new run of a pipeline.
 
-### 🚀 Releases
-
-- **release_get_definitions**: Retrieve a list of release definitions for a given project.
-- **release_get_releases**: Retrieve a list of releases for a given project.
-
-### 🔒 Advanced Security
+### Advanced Security
 
 - **advsec_get_alerts**: Retrieve Advanced Security alerts for a repository.
 - **advsec_get_alert_details**: Get detailed information about a specific Advanced Security alert.
@@ -242,6 +239,37 @@ Open GitHub Copilot Chat and try a prompt like `List ADO projects`.
 
 See the [getting started documentation](./docs/GETTINGSTARTED.md) to use our MCP Server with other tools such as Visual Studio 2022, Claude Code, and Cursor.
 
+## 🌏 Using Domains
+
+Azure DevOps exposes a large surface area. As a result, our Azure DevOps MCP Server includes many tools. To keep the toolset manageable, avoid confusing the model, and respect client limits on loaded tools, use Domains to load only the areas you need. Domains are named groups of related tools (for example: core, work, work-items, repositories, wiki). Add the `-d` argument and the domain names to the server args in your `mcp.json` to list the domains to enable.
+
+For example, use `"-d", "core", "work", "work-items"` to load only Work Item related tools (see the example below).
+
+```json
+{
+  "inputs": [
+    {
+      "id": "ado_org",
+      "type": "promptString",
+      "description": "Azure DevOps organization name  (e.g. 'contoso')"
+    }
+  ],
+  "servers": {
+    "ado": {
+      "type": "stdio",
+      "command": "mcp-server-azuredevops",
+      "args": ["${input:ado_org}", "-d", "core", "work", "work-items"]
+    }
+  }
+}
+```
+
+Domains that are available are: `core`, `work`, `work-items`, `search`, `test-plans`, `repositories`, `wiki`, `pipelines`, `advanced-security`
+
+We recommend that you always enable `core` tools so that you can fetch project level information.
+
+> By default all domains are loaded
+
 ## 📝 Troubleshooting
 
 See the [Troubleshooting guide](./docs/TROUBLESHOOTING.md) for help with common issues and logging.

package/dist/shared/domains.js

@@ -6,9 +6,8 @@
 export var Domain;
 (function (Domain) {
     Domain["ADVANCED_SECURITY"] = "advanced-security";
-    Domain["BUILDS"] = "builds";
+    Domain["PIPELINES"] = "pipelines";
     Domain["CORE"] = "core";
-    Domain["RELEASES"] = "releases";
     Domain["REPOSITORIES"] = "repositories";
     Domain["SEARCH"] = "search";
     Domain["TEST_PLANS"] = "test-plans";
@@ -25,8 +24,7 @@ export class DomainsManager {
     enabledDomains;
     constructor(domainsInput) {
         this.enabledDomains = new Set();
-        const normalizedInput = DomainsManager.parseDomainsInput(domainsInput);
-        this.parseDomains(normalizedInput);
+        this.parseDomains(domainsInput);
     }
     /**
      * Parse and validate domains from input
@@ -48,10 +46,6 @@ export class DomainsManager {
             this.enableAllDomains();
             return;
         }
-        if (domainsInput.length === 1 && domainsInput[0] === ALL_DOMAINS) {
-            this.enableAllDomains();
-            return;
-        }
         const domains = domainsInput.map((d) => d.trim().toLowerCase());
         this.validateAndAddDomains(domains);
     }
@@ -60,7 +54,8 @@ export class DomainsManager {
             this.enableAllDomains();
             return;
         }
-        const domains = [domainsInput.trim().toLowerCase()];
+        // Handle comma-separated domains
+        const domains = domainsInput.split(",").map((d) => d.trim().toLowerCase());
         this.validateAndAddDomains(domains);
     }
     validateAndAddDomains(domains) {

package/dist/tools/{builds.js → pipelines.js}

@@ -4,19 +4,21 @@ import { apiVersion, getEnumKeys, safeEnumConvert } from "../utils.js";
 import { BuildQueryOrder, DefinitionQueryOrder } from "azure-devops-node-api/interfaces/BuildInterfaces.js";
 import { z } from "zod";
 import { StageUpdateType } from "azure-devops-node-api/interfaces/BuildInterfaces.js";
-const BUILD_TOOLS = {
-    get_definitions: "build_get_definitions",
-    get_definition_revisions: "build_get_definition_revisions",
-    get_builds: "build_get_builds",
-    get_log: "build_get_log",
-    get_log_by_id: "build_get_log_by_id",
-    get_changes: "build_get_changes",
-    run_build: "build_run_build",
-    get_status: "build_get_status",
-    update_build_stage: "build_update_build_stage",
+const PIPELINE_TOOLS = {
+    pipelines_get_builds: "pipelines_get_builds",
+    pipelines_get_build_changes: "pipelines_get_build_changes",
+    pipelines_get_build_definitions: "pipelines_get_build_definitions",
+    pipelines_get_build_definition_revisions: "pipelines_get_build_definition_revisions",
+    pipelines_get_build_log: "pipelines_get_build_log",
+    pipelines_get_build_log_by_id: "pipelines_get_build_log_by_id",
+    pipelines_get_build_status: "pipelines_get_build_status",
+    pipelines_update_build_stage: "pipelines_update_build_stage",
+    pipelines_get_run: "pipelines_get_run",
+    pipelines_list_runs: "pipelines_list_runs",
+    pipelines_run_pipeline: "pipelines_run_pipeline",
 };
-function configureBuildTools(server, tokenProvider, connectionProvider, userAgentProvider) {
-    server.tool(BUILD_TOOLS.get_definitions, "Retrieves a list of build definitions for a given project.", {
+function configurePipelineTools(server, tokenProvider, connectionProvider, userAgentProvider) {
+    server.tool(PIPELINE_TOOLS.pipelines_get_build_definitions, "Retrieves a list of build definitions for a given project.", {
         project: z.string().describe("Project ID or name to get build definitions for"),
         repositoryId: z.string().optional().describe("Repository ID to filter build definitions"),
         repositoryType: z.enum(["TfsGit", "GitHub", "BitbucketCloud"]).optional().describe("Type of repository to filter build definitions"),
@@ -45,7 +47,7 @@ function configureBuildTools(server, tokenProvider, connectionProvider, userAgen
             content: [{ type: "text", text: JSON.stringify(buildDefinitions, null, 2) }],
         };
     });
-    server.tool(BUILD_TOOLS.get_definition_revisions, "Retrieves a list of revisions for a specific build definition.", {
+    server.tool(PIPELINE_TOOLS.pipelines_get_build_definition_revisions, "Retrieves a list of revisions for a specific build definition.", {
         project: z.string().describe("Project ID or name to get the build definition revisions for"),
         definitionId: z.number().describe("ID of the build definition to get revisions for"),
     }, async ({ project, definitionId }) => {
@@ -56,7 +58,7 @@ function configureBuildTools(server, tokenProvider, connectionProvider, userAgen
             content: [{ type: "text", text: JSON.stringify(revisions, null, 2) }],
         };
     });
-    server.tool(BUILD_TOOLS.get_builds, "Retrieves a list of builds for a given project.", {
+    server.tool(PIPELINE_TOOLS.pipelines_get_builds, "Retrieves a list of builds for a given project.", {
         project: z.string().describe("Project ID or name to get builds for"),
         definitions: z.array(z.number()).optional().describe("Array of build definition IDs to filter builds"),
         queues: z.array(z.number()).optional().describe("Array of queue IDs to filter builds"),
@@ -90,7 +92,7 @@ function configureBuildTools(server, tokenProvider, connectionProvider, userAgen
             content: [{ type: "text", text: JSON.stringify(builds, null, 2) }],
         };
     });
-    server.tool(BUILD_TOOLS.get_log, "Retrieves the logs for a specific build.", {
+    server.tool(PIPELINE_TOOLS.pipelines_get_build_log, "Retrieves the logs for a specific build.", {
         project: z.string().describe("Project ID or name to get the build log for"),
         buildId: z.number().describe("ID of the build to get the log for"),
     }, async ({ project, buildId }) => {
@@ -101,7 +103,7 @@ function configureBuildTools(server, tokenProvider, connectionProvider, userAgen
             content: [{ type: "text", text: JSON.stringify(logs, null, 2) }],
         };
     });
-    server.tool(BUILD_TOOLS.get_log_by_id, "Get a specific build log by log ID.", {
+    server.tool(PIPELINE_TOOLS.pipelines_get_build_log_by_id, "Get a specific build log by log ID.", {
         project: z.string().describe("Project ID or name to get the build log for"),
         buildId: z.number().describe("ID of the build to get the log for"),
         logId: z.number().describe("ID of the log to retrieve"),
@@ -115,7 +117,7 @@ function configureBuildTools(server, tokenProvider, connectionProvider, userAgen
             content: [{ type: "text", text: JSON.stringify(logLines, null, 2) }],
         };
     });
-    server.tool(BUILD_TOOLS.get_changes, "Get the changes associated with a specific build.", {
+    server.tool(PIPELINE_TOOLS.pipelines_get_build_changes, "Get the changes associated with a specific build.", {
         project: z.string().describe("Project ID or name to get the build changes for"),
         buildId: z.number().describe("ID of the build to get changes for"),
         continuationToken: z.string().optional().describe("Continuation token for pagination"),
@@ -129,38 +131,99 @@ function configureBuildTools(server, tokenProvider, connectionProvider, userAgen
             content: [{ type: "text", text: JSON.stringify(changes, null, 2) }],
         };
     });
-    server.tool(BUILD_TOOLS.run_build, "Triggers a new build for a specified definition.", {
+    server.tool(PIPELINE_TOOLS.pipelines_get_run, "Gets a run for a particular pipeline.", {
         project: z.string().describe("Project ID or name to run the build in"),
-        definitionId: z.number().describe("ID of the build definition to run"),
-        sourceBranch: z.string().optional().describe("Source branch to run the build from. If not provided, the default branch will be used."),
-        parameters: z.record(z.string(), z.string()).optional().describe("Custom build parameters as key-value pairs"),
-    }, async ({ project, definitionId, sourceBranch, parameters }) => {
+        pipelineId: z.number().describe("ID of the pipeline to run"),
+        runId: z.number().describe("ID of the run to get"),
+    }, async ({ project, pipelineId, runId }) => {
+        const connection = await connectionProvider();
+        const pipelinesApi = await connection.getPipelinesApi();
+        const pipelineRun = await pipelinesApi.getRun(project, pipelineId, runId);
+        return {
+            content: [{ type: "text", text: JSON.stringify(pipelineRun, null, 2) }],
+        };
+    });
+    server.tool(PIPELINE_TOOLS.pipelines_list_runs, "Gets top 10000 runs for a particular pipeline.", {
+        project: z.string().describe("Project ID or name to run the build in"),
+        pipelineId: z.number().describe("ID of the pipeline to run"),
+    }, async ({ project, pipelineId }) => {
+        const connection = await connectionProvider();
+        const pipelinesApi = await connection.getPipelinesApi();
+        const pipelineRuns = await pipelinesApi.listRuns(project, pipelineId);
+        return {
+            content: [{ type: "text", text: JSON.stringify(pipelineRuns, null, 2) }],
+        };
+    });
+    const variableSchema = z.object({
+        value: z.string().optional(),
+        isSecret: z.boolean().optional(),
+    });
+    const resourcesSchema = z.object({
+        builds: z
+            .record(z.string().describe("Name of the build resource."), z.object({
+            version: z.string().optional().describe("Version of the build resource."),
+        }))
+            .optional(),
+        containers: z
+            .record(z.string().describe("Name of the container resource."), z.object({
+            version: z.string().optional().describe("Version of the container resource."),
+        }))
+            .optional(),
+        packages: z
+            .record(z.string().describe("Name of the package resource."), z.object({
+            version: z.string().optional().describe("Version of the package resource."),
+        }))
+            .optional(),
+        pipelines: z.record(z.string().describe("Name of the pipeline resource."), z.object({
+            runId: z.number().describe("Id of the source pipeline run that triggered or is referenced by this pipeline run."),
+            version: z.string().optional().describe("Version of the source pipeline run."),
+        })),
+        repositories: z
+            .record(z.string().describe("Name of the repository resource."), z.object({
+            refName: z.string().describe("Reference name, e.g., refs/heads/main."),
+            token: z.string().optional(),
+            tokenType: z.string().optional(),
+            version: z.string().optional().describe("Version of the repository resource, git commit sha."),
+        }))
+            .optional(),
+    });
+    server.tool(PIPELINE_TOOLS.pipelines_run_pipeline, "Starts a new run of a pipeline.", {
+        project: z.string().describe("Project ID or name to run the build in"),
+        pipelineId: z.number().describe("ID of the pipeline to run"),
+        pipelineVersion: z.number().optional().describe("Version of the pipeline to run. If not provided, the latest version will be used."),
+        previewRun: z.boolean().optional().describe("If true, returns the final YAML document after parsing templates without creating a new run."),
+        resources: resourcesSchema.optional().describe("A dictionary of resources to pass to the pipeline."),
+        stagesToSkip: z.array(z.string()).optional().describe("A list of stages to skip."),
+        templateParameters: z.record(z.string(), z.string()).optional().describe("Custom build parameters as key-value pairs"),
+        variables: z.record(z.string(), variableSchema).optional().describe("A dictionary of variables to pass to the pipeline."),
+        yamlOverride: z.string().optional().describe("YAML override for the pipeline run."),
+    }, async ({ project, pipelineId, pipelineVersion, previewRun, resources, stagesToSkip, templateParameters, variables, yamlOverride }) => {
+        if (!previewRun && yamlOverride) {
+            throw new Error("Parameter 'yamlOverride' can only be specified together with parameter 'previewRun'.");
+        }
         const connection = await connectionProvider();
-        const buildApi = await connection.getBuildApi();
         const pipelinesApi = await connection.getPipelinesApi();
-        const definition = await buildApi.getDefinition(project, definitionId);
         const runRequest = {
+            previewRun: previewRun,
             resources: {
-                repositories: {
-                    self: {
-                        refName: sourceBranch || definition.repository?.defaultBranch || "refs/heads/main",
-                    },
-                },
+                ...resources,
             },
-            templateParameters: parameters,
+            stagesToSkip: stagesToSkip,
+            templateParameters: templateParameters,
+            variables: variables,
+            yamlOverride: yamlOverride,
         };
-        const pipelineRun = await pipelinesApi.runPipeline(runRequest, project, definitionId);
+        const pipelineRun = await pipelinesApi.runPipeline(runRequest, project, pipelineId, pipelineVersion);
         const queuedBuild = { id: pipelineRun.id };
         const buildId = queuedBuild.id;
         if (buildId === undefined) {
             throw new Error("Failed to get build ID from pipeline run");
         }
-        const buildReport = await buildApi.getBuildReport(project, buildId);
         return {
-            content: [{ type: "text", text: JSON.stringify(buildReport, null, 2) }],
+            content: [{ type: "text", text: JSON.stringify(pipelineRun, null, 2) }],
         };
     });
-    server.tool(BUILD_TOOLS.get_status, "Fetches the status of a specific build.", {
+    server.tool(PIPELINE_TOOLS.pipelines_get_build_status, "Fetches the status of a specific build.", {
         project: z.string().describe("Project ID or name to get the build status for"),
         buildId: z.number().describe("ID of the build to get the status for"),
     }, async ({ project, buildId }) => {
@@ -171,7 +234,7 @@ function configureBuildTools(server, tokenProvider, connectionProvider, userAgen
             content: [{ type: "text", text: JSON.stringify(build, null, 2) }],
         };
     });
-    server.tool(BUILD_TOOLS.update_build_stage, "Updates the stage of a specific build.", {
+    server.tool(PIPELINE_TOOLS.pipelines_update_build_stage, "Updates the stage of a specific build.", {
         project: z.string().describe("Project ID or name to update the build stage for"),
         buildId: z.number().describe("ID of the build to update"),
         stageName: z.string().describe("Name of the stage to update"),
@@ -205,4 +268,4 @@ function configureBuildTools(server, tokenProvider, connectionProvider, userAgen
         };
     });
 }
-export { BUILD_TOOLS, configureBuildTools };
+export { PIPELINE_TOOLS, configurePipelineTools };

package/dist/tools/repositories.js

@@ -199,11 +199,17 @@ function configureRepoTools(server, tokenProvider, connectionProvider, userAgent
         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'."),
-    }, async ({ repositoryId, top, skip, created_by_me, created_by_user, i_am_reviewer, status }) => {
+        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 }) => {
         const connection = await connectionProvider();
         const gitApi = await connection.getGitApi();
         // Build the search criteria
@@ -211,6 +217,12 @@ function configureRepoTools(server, tokenProvider, connectionProvider, userAgent
             status: pullRequestStatusStringToInt(status),
             repositoryId: repositoryId,
         };
+        if (sourceRefName) {
+            searchCriteria.sourceRefName = sourceRefName;
+        }
+        if (targetRefName) {
+            searchCriteria.targetRefName = targetRefName;
+        }
         if (created_by_user) {
             try {
                 const userId = await getUserIdFromEmail(created_by_user, tokenProvider, connectionProvider, userAgentProvider);
@@ -228,16 +240,33 @@ function configureRepoTools(server, tokenProvider, connectionProvider, userAgent
                 };
             }
         }
-        else if (created_by_me || i_am_reviewer) {
+        else if (created_by_me) {
             const data = await getCurrentUserDetails(tokenProvider, connectionProvider, userAgentProvider);
             const userId = data.authenticatedUser.id;
-            if (created_by_me) {
-                searchCriteria.creatorId = userId;
+            searchCriteria.creatorId = userId;
+        }
+        if (user_is_reviewer) {
+            try {
+                const reviewerUserId = await getUserIdFromEmail(user_is_reviewer, tokenProvider, connectionProvider, userAgentProvider);
+                searchCriteria.reviewerId = reviewerUserId;
             }
-            if (i_am_reviewer) {
-                searchCriteria.reviewerId = userId;
+            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;
+            searchCriteria.reviewerId = userId;
+        }
         const pullRequests = await gitApi.getPullRequests(repositoryId, searchCriteria, undefined, // project
         undefined, // maxCommentLength
         skip, top);
@@ -267,17 +296,29 @@ function configureRepoTools(server, tokenProvider, connectionProvider, userAgent
         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'."),
-    }, async ({ project, top, skip, created_by_me, created_by_user, i_am_reviewer, status }) => {
+        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);
@@ -295,16 +336,33 @@ function configureRepoTools(server, tokenProvider, connectionProvider, userAgent
                 };
             }
         }
-        else if (created_by_me || i_am_reviewer) {
+        else if (created_by_me) {
             const data = await getCurrentUserDetails(tokenProvider, connectionProvider, userAgentProvider);
             const userId = data.authenticatedUser.id;
-            if (created_by_me) {
-                gitPullRequestSearchCriteria.creatorId = userId;
+            gitPullRequestSearchCriteria.creatorId = userId;
+        }
+        if (user_is_reviewer) {
+            try {
+                const reviewerUserId = await getUserIdFromEmail(user_is_reviewer, tokenProvider, connectionProvider, userAgentProvider);
+                gitPullRequestSearchCriteria.reviewerId = reviewerUserId;
             }
-            if (i_am_reviewer) {
-                gitPullRequestSearchCriteria.reviewerId = userId;
+            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;
+        }
         const pullRequests = await gitApi.getPullRequestsByProject(project, gitPullRequestSearchCriteria, undefined, // maxCommentLength
         skip, top);
         // Filter out the irrelevant properties

package/dist/tools.js

@@ -2,9 +2,8 @@
 // Licensed under the MIT License.
 import { Domain } from "./shared/domains.js";
 import { configureAdvSecTools } from "./tools/advanced-security.js";
-import { configureBuildTools } from "./tools/builds.js";
+import { configurePipelineTools } from "./tools/pipelines.js";
 import { configureCoreTools } from "./tools/core.js";
-import { configureReleaseTools } from "./tools/releases.js";
 import { configureRepoTools } from "./tools/repositories.js";
 import { configureSearchTools } from "./tools/search.js";
 import { configureTestPlanTools } from "./tools/test-plans.js";
@@ -19,10 +18,9 @@ function configureAllTools(server, tokenProvider, connectionProvider, userAgentP
     };
     configureIfDomainEnabled(Domain.CORE, () => configureCoreTools(server, tokenProvider, connectionProvider, userAgentProvider));
     configureIfDomainEnabled(Domain.WORK, () => configureWorkTools(server, tokenProvider, connectionProvider));
-    configureIfDomainEnabled(Domain.BUILDS, () => configureBuildTools(server, tokenProvider, connectionProvider, userAgentProvider));
+    configureIfDomainEnabled(Domain.PIPELINES, () => configurePipelineTools(server, tokenProvider, connectionProvider, userAgentProvider));
     configureIfDomainEnabled(Domain.REPOSITORIES, () => configureRepoTools(server, tokenProvider, connectionProvider, userAgentProvider));
     configureIfDomainEnabled(Domain.WORK_ITEMS, () => configureWorkItemTools(server, tokenProvider, connectionProvider, userAgentProvider));
-    configureIfDomainEnabled(Domain.RELEASES, () => configureReleaseTools(server, tokenProvider, connectionProvider));
     configureIfDomainEnabled(Domain.WIKI, () => configureWikiTools(server, tokenProvider, connectionProvider));
     configureIfDomainEnabled(Domain.TEST_PLANS, () => configureTestPlanTools(server, tokenProvider, connectionProvider));
     configureIfDomainEnabled(Domain.SEARCH, () => configureSearchTools(server, tokenProvider, connectionProvider, userAgentProvider));

package/dist/version.js

@@ -1 +1 @@
-export const packageVersion = "2.0.0";
+export const packageVersion = "2.1.0-nightly.20250910";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@azure-devops/mcp",
-  "version": "2.0.0",
+  "version": "2.1.0-nightly.20250910",
   "description": "MCP server for interacting with Azure DevOps",
   "license": "MIT",
   "author": "Microsoft Corporation",

package/dist/tools/releases.js

@@ -1,97 +0,0 @@
-// Copyright (c) Microsoft Corporation.
-// Licensed under the MIT License.
-import { ReleaseDefinitionExpands, ReleaseDefinitionQueryOrder, ReleaseExpands, ReleaseStatus, ReleaseQueryOrder } from "azure-devops-node-api/interfaces/ReleaseInterfaces.js";
-import { z } from "zod";
-import { getEnumKeys, safeEnumConvert } from "../utils.js";
-const RELEASE_TOOLS = {
-    get_release_definitions: "release_get_definitions",
-    get_releases: "release_get_releases",
-};
-function configureReleaseTools(server, tokenProvider, connectionProvider) {
-    server.tool(RELEASE_TOOLS.get_release_definitions, "Retrieves list of release definitions for a given project.", {
-        project: z.string().describe("Project ID or name to get release definitions for"),
-        searchText: z.string().optional().describe("Search text to filter release definitions"),
-        expand: z
-            .enum(getEnumKeys(ReleaseDefinitionExpands))
-            .default("None")
-            .describe("Expand options for release definitions"),
-        artifactType: z.string().optional().describe("Filter by artifact type"),
-        artifactSourceId: z.string().optional().describe("Filter by artifact source ID"),
-        top: z.number().optional().describe("Number of results to return (for pagination)"),
-        continuationToken: z.string().optional().describe("Continuation token for pagination"),
-        queryOrder: z
-            .enum(getEnumKeys(ReleaseDefinitionQueryOrder))
-            .default("NameAscending")
-            .describe("Order of the results"),
-        path: z.string().optional().describe("Path to filter release definitions"),
-        isExactNameMatch: z.boolean().optional().default(false).describe("Whether to match the exact name of the release definition. Default is false."),
-        tagFilter: z.array(z.string()).optional().describe("Filter by tags associated with the release definitions"),
-        propertyFilters: z.array(z.string()).optional().describe("Filter by properties associated with the release definitions"),
-        definitionIdFilter: z.array(z.string()).optional().describe("Filter by specific release definition IDs"),
-        isDeleted: z.boolean().default(false).describe("Whether to include deleted release definitions. Default is false."),
-        searchTextContainsFolderName: z.boolean().optional().describe("Whether to include folder names in the search text"),
-    }, async ({ project, searchText, expand, artifactType, artifactSourceId, top, continuationToken, queryOrder, path, isExactNameMatch, tagFilter, propertyFilters, definitionIdFilter, isDeleted, searchTextContainsFolderName, }) => {
-        const connection = await connectionProvider();
-        const releaseApi = await connection.getReleaseApi();
-        const releaseDefinitions = await releaseApi.getReleaseDefinitions(project, searchText, safeEnumConvert(ReleaseDefinitionExpands, expand), artifactType, artifactSourceId, top, continuationToken, safeEnumConvert(ReleaseDefinitionQueryOrder, queryOrder), path, isExactNameMatch, tagFilter, propertyFilters, definitionIdFilter, isDeleted, searchTextContainsFolderName);
-        return {
-            content: [{ type: "text", text: JSON.stringify(releaseDefinitions, null, 2) }],
-        };
-    });
-    server.tool(RELEASE_TOOLS.get_releases, "Retrieves a list of releases for a given project.", {
-        project: z.string().optional().describe("Project ID or name to get releases for"),
-        definitionId: z.number().optional().describe("ID of the release definition to filter releases"),
-        definitionEnvironmentId: z.number().optional().describe("ID of the definition environment to filter releases"),
-        searchText: z.string().optional().describe("Search text to filter releases"),
-        createdBy: z.string().optional().describe("User ID or name who created the release"),
-        statusFilter: z
-            .enum(getEnumKeys(ReleaseStatus))
-            .optional()
-            .default("Active")
-            .describe("Status of the releases to filter (default: Active)"),
-        environmentStatusFilter: z.number().optional().describe("Environment status to filter releases"),
-        minCreatedTime: z.coerce
-            .date()
-            .optional()
-            .default(() => {
-            const sevenDaysAgo = new Date();
-            sevenDaysAgo.setDate(sevenDaysAgo.getDate() - 7);
-            return sevenDaysAgo;
-        })
-            .describe("Minimum created time for releases (default: 7 days ago)"),
-        maxCreatedTime: z.coerce
-            .date()
-            .optional()
-            .default(() => new Date())
-            .describe("Maximum created time for releases (default: now)"),
-        queryOrder: z
-            .enum(getEnumKeys(ReleaseQueryOrder))
-            .optional()
-            .default("Ascending")
-            .describe("Order in which to return releases (default: Ascending)"),
-        top: z.number().optional().describe("Number of releases to return"),
-        continuationToken: z.number().optional().describe("Continuation token for pagination"),
-        expand: z
-            .enum(getEnumKeys(ReleaseExpands))
-            .optional()
-            .default("None")
-            .describe("Expand options for releases"),
-        artifactTypeId: z.string().optional().describe("Filter releases by artifact type ID"),
-        sourceId: z.string().optional().describe("Filter releases by artifact source ID"),
-        artifactVersionId: z.string().optional().describe("Filter releases by artifact version ID"),
-        sourceBranchFilter: z.string().optional().describe("Filter releases by source branch"),
-        isDeleted: z.boolean().optional().default(false).describe("Whether to include deleted releases (default: false)"),
-        tagFilter: z.array(z.string()).optional().describe("Filter releases by tags"),
-        propertyFilters: z.array(z.string()).optional().describe("Filter releases by properties"),
-        releaseIdFilter: z.array(z.number()).optional().describe("Filter by specific release IDs"),
-        path: z.string().optional().describe("Path to filter releases"),
-    }, async ({ project, definitionId, definitionEnvironmentId, searchText, createdBy, statusFilter, environmentStatusFilter, minCreatedTime, maxCreatedTime, queryOrder, top, continuationToken, expand, artifactTypeId, sourceId, artifactVersionId, sourceBranchFilter, isDeleted, tagFilter, propertyFilters, releaseIdFilter, path, }) => {
-        const connection = await connectionProvider();
-        const releaseApi = await connection.getReleaseApi();
-        const releases = await releaseApi.getReleases(project, definitionId, definitionEnvironmentId, searchText, createdBy, safeEnumConvert(ReleaseStatus, statusFilter), environmentStatusFilter, minCreatedTime, maxCreatedTime, safeEnumConvert(ReleaseQueryOrder, queryOrder), top, continuationToken, safeEnumConvert(ReleaseExpands, expand), artifactTypeId, sourceId, artifactVersionId, sourceBranchFilter, isDeleted, tagFilter, propertyFilters, releaseIdFilter, path);
-        return {
-            content: [{ type: "text", text: JSON.stringify(releases, null, 2) }],
-        };
-    });
-}
-export { RELEASE_TOOLS, configureReleaseTools };