@azure-devops/mcp 2.0.0-nightly.20250902 → 2.0.0-nightly.20250904

package/README.md

@@ -27,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'"
@@ -103,26 +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_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.
@@ -270,7 +264,7 @@ For example, use `"-d", "core", "work", "work-items"` to load only Work Item rel
 }
 ```
 
-Domains that are available are: `core`, `work`, `work-items`, `search`, `test-plans`, `repositories`, `wiki`, `builds`, `releases`, `advanced-security`
+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.
 

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,21 +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_builds: "build_get_builds",
-    get_changes: "build_get_changes",
-    get_definitions: "build_get_definitions",
-    get_definition_revisions: "build_get_definition_revisions",
-    get_log: "build_get_log",
-    get_log_by_id: "build_get_log_by_id",
-    get_status: "build_get_status",
+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",
-    update_build_stage: "build_update_build_stage",
 };
-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"),
@@ -47,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 }) => {
@@ -58,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"),
@@ -92,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 }) => {
@@ -103,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"),
@@ -117,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"),
@@ -131,7 +131,7 @@ function configureBuildTools(server, tokenProvider, connectionProvider, userAgen
             content: [{ type: "text", text: JSON.stringify(changes, null, 2) }],
         };
     });
-    server.tool(BUILD_TOOLS.pipelines_get_run, "Gets a run for a particular pipeline.", {
+    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"),
         pipelineId: z.number().describe("ID of the pipeline to run"),
         runId: z.number().describe("ID of the run to get"),
@@ -143,7 +143,7 @@ function configureBuildTools(server, tokenProvider, connectionProvider, userAgen
             content: [{ type: "text", text: JSON.stringify(pipelineRun, null, 2) }],
         };
     });
-    server.tool(BUILD_TOOLS.pipelines_list_runs, "Gets top 10000 runs for a particular pipeline.", {
+    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 }) => {
@@ -187,7 +187,7 @@ function configureBuildTools(server, tokenProvider, connectionProvider, userAgen
         }))
             .optional(),
     });
-    server.tool(BUILD_TOOLS.pipelines_run_pipeline, "Starts a new run of a pipeline.", {
+    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."),
@@ -223,7 +223,7 @@ function configureBuildTools(server, tokenProvider, connectionProvider, userAgen
             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 }) => {
@@ -234,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"),
@@ -268,4 +268,4 @@ function configureBuildTools(server, tokenProvider, connectionProvider, userAgen
         };
     });
 }
-export { BUILD_TOOLS, configureBuildTools };
+export { PIPELINE_TOOLS, configurePipelineTools };

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-nightly.20250902";
+export const packageVersion = "2.0.0-nightly.20250904";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@azure-devops/mcp",
-  "version": "2.0.0-nightly.20250902",
+  "version": "2.0.0-nightly.20250904",
   "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 };