@azure-devops/mcp 0.1.0 → 0.2.0-preview-oauth

package/dist/tools/builds.js

@@ -1,31 +1,39 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT License.
+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_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"
+    get_status: "build_get_status",
+    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) {
+function configureBuildTools(server, tokenProvider, connectionProvider, userAgentProvider) {
     server.tool(BUILD_TOOLS.get_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"),
         name: z.string().optional().describe("Name of the build definition to filter"),
         path: z.string().optional().describe("Path of the build definition to filter"),
-        queryOrder: z.nativeEnum(DefinitionQueryOrder).optional().describe("Order in which build definitions are returned"),
+        queryOrder: z
+            .enum(getEnumKeys(DefinitionQueryOrder))
+            .optional()
+            .describe("Order in which build definitions are returned"),
         top: z.number().optional().describe("Maximum number of build definitions to return"),
         continuationToken: z.string().optional().describe("Token for continuing paged results"),
-        minMetricsTime: z.date().optional().describe("Minimum metrics time to filter build definitions"),
+        minMetricsTime: z.coerce.date().optional().describe("Minimum metrics time to filter build definitions"),
         definitionIds: z.array(z.number()).optional().describe("Array of build definition IDs to filter"),
-        builtAfter: z.date().optional().describe("Return definitions that have builds after this date"),
-        notBuiltAfter: z.date().optional().describe("Return definitions that do not have builds after this date"),
+        builtAfter: z.coerce.date().optional().describe("Return definitions that have builds after this date"),
+        notBuiltAfter: z.coerce.date().optional().describe("Return definitions that do not have builds after this date"),
         includeAllProperties: z.boolean().optional().describe("Whether to include all properties in the results"),
         includeLatestBuilds: z.boolean().optional().describe("Whether to include the latest builds for each definition"),
         taskIdFilter: z.string().optional().describe("Task ID to filter build definitions"),
@@ -34,7 +42,7 @@ function configureBuildTools(server, tokenProvider, connectionProvider) {
     }, async ({ project, repositoryId, repositoryType, name, path, queryOrder, top, continuationToken, minMetricsTime, definitionIds, builtAfter, notBuiltAfter, includeAllProperties, includeLatestBuilds, taskIdFilter, processType, yamlFilename, }) => {
         const connection = await connectionProvider();
         const buildApi = await connection.getBuildApi();
-        const buildDefinitions = await buildApi.getDefinitions(project, name, repositoryId, repositoryType, queryOrder, top, continuationToken, minMetricsTime, definitionIds, path, builtAfter, notBuiltAfter, includeAllProperties, includeLatestBuilds, taskIdFilter, processType, yamlFilename);
+        const buildDefinitions = await buildApi.getDefinitions(project, name, repositoryId, repositoryType, safeEnumConvert(DefinitionQueryOrder, queryOrder), top, continuationToken, minMetricsTime, definitionIds, path, builtAfter, notBuiltAfter, includeAllProperties, includeLatestBuilds, taskIdFilter, processType, yamlFilename);
         return {
             content: [{ type: "text", text: JSON.stringify(buildDefinitions, null, 2) }],
         };
@@ -55,8 +63,8 @@ function configureBuildTools(server, tokenProvider, connectionProvider) {
         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"),
         buildNumber: z.string().optional().describe("Build number to filter builds"),
-        minTime: z.date().optional().describe("Minimum finish time to filter builds"),
-        maxTime: z.date().optional().describe("Maximum finish time to filter builds"),
+        minTime: z.coerce.date().optional().describe("Minimum finish time to filter builds"),
+        maxTime: z.coerce.date().optional().describe("Maximum finish time to filter builds"),
         requestedFor: z.string().optional().describe("User ID or name who requested the build"),
         reasonFilter: z.number().optional().describe("Reason filter for the build (see BuildReason enum)"),
         statusFilter: z.number().optional().describe("Status filter for the build (see BuildStatus enum)"),
@@ -67,7 +75,11 @@ function configureBuildTools(server, tokenProvider, connectionProvider) {
         continuationToken: z.string().optional().describe("Token for continuing paged results"),
         maxBuildsPerDefinition: z.number().optional().describe("Maximum number of builds per definition"),
         deletedFilter: z.number().optional().describe("Filter for deleted builds (see QueryDeletedOption enum)"),
-        queryOrder: z.nativeEnum(BuildQueryOrder).default(BuildQueryOrder.QueueTimeDescending).optional().describe("Order in which builds are returned"),
+        queryOrder: z
+            .enum(getEnumKeys(BuildQueryOrder))
+            .default("QueueTimeDescending")
+            .optional()
+            .describe("Order in which builds are returned"),
         branchName: z.string().optional().describe("Branch name to filter builds"),
         buildIds: z.array(z.number()).optional().describe("Array of build IDs to retrieve"),
         repositoryId: z.string().optional().describe("Repository ID to filter builds"),
@@ -75,7 +87,7 @@ function configureBuildTools(server, tokenProvider, connectionProvider) {
     }, async ({ project, definitions, queues, buildNumber, minTime, maxTime, requestedFor, reasonFilter, statusFilter, resultFilter, tagFilters, properties, top, continuationToken, maxBuildsPerDefinition, deletedFilter, queryOrder, branchName, buildIds, repositoryId, repositoryType, }) => {
         const connection = await connectionProvider();
         const buildApi = await connection.getBuildApi();
-        const builds = await buildApi.getBuilds(project, definitions, queues, buildNumber, minTime, maxTime, requestedFor, reasonFilter, statusFilter, resultFilter, tagFilters, properties, top, continuationToken, maxBuildsPerDefinition, deletedFilter, queryOrder, branchName, buildIds, repositoryId, repositoryType);
+        const builds = await buildApi.getBuilds(project, definitions, queues, buildNumber, minTime, maxTime, requestedFor, reasonFilter, statusFilter, resultFilter, tagFilters, properties, top, continuationToken, maxBuildsPerDefinition, deletedFilter, safeEnumConvert(BuildQueryOrder, queryOrder), branchName, buildIds, repositoryId, repositoryType);
         return {
             content: [{ type: "text", text: JSON.stringify(builds, null, 2) }],
         };
@@ -119,16 +131,96 @@ function configureBuildTools(server, tokenProvider, connectionProvider) {
             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(BUILD_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."),
-    }, async ({ project, definitionId, sourceBranch }) => {
+        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 buildApi = await connection.getBuildApi();
-        const build = await buildApi.queueBuild({ definition: { id: definitionId }, sourceBranch }, project);
+        const pipelinesApi = await connection.getPipelinesApi();
+        const pipelineRun = await pipelinesApi.getRun(project, pipelineId, runId);
         return {
-            content: [{ type: "text", text: JSON.stringify(build, null, 2) }],
+            content: [{ type: "text", text: JSON.stringify(pipelineRun, null, 2) }],
+        };
+    });
+    server.tool(BUILD_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(BUILD_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 pipelinesApi = await connection.getPipelinesApi();
+        const runRequest = {
+            previewRun: previewRun,
+            resources: {
+                ...resources,
+            },
+            stagesToSkip: stagesToSkip,
+            templateParameters: templateParameters,
+            variables: variables,
+            yamlOverride: yamlOverride,
+        };
+        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");
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(pipelineRun, null, 2) }],
         };
     });
     server.tool(BUILD_TOOLS.get_status, "Fetches the status of a specific build.", {
@@ -142,5 +234,38 @@ function configureBuildTools(server, tokenProvider, connectionProvider) {
             content: [{ type: "text", text: JSON.stringify(build, null, 2) }],
         };
     });
+    server.tool(BUILD_TOOLS.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"),
+        status: z.enum(getEnumKeys(StageUpdateType)).describe("New status for the stage"),
+        forceRetryAllJobs: z.boolean().default(false).describe("Whether to force retry all jobs in the stage."),
+    }, async ({ project, buildId, stageName, status, forceRetryAllJobs }) => {
+        const connection = await connectionProvider();
+        const orgUrl = connection.serverUrl;
+        const endpoint = `${orgUrl}/${project}/_apis/build/builds/${buildId}/stages/${stageName}?api-version=${apiVersion}`;
+        const token = await tokenProvider();
+        const body = {
+            forceRetryAllJobs: forceRetryAllJobs,
+            state: safeEnumConvert(StageUpdateType, status),
+        };
+        const response = await fetch(endpoint, {
+            method: "PATCH",
+            headers: {
+                "Content-Type": "application/json",
+                "Authorization": `Bearer ${token}`,
+                "User-Agent": userAgentProvider(),
+            },
+            body: JSON.stringify(body),
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`Failed to update build stage: ${response.status} ${errorText}`);
+        }
+        const updatedBuild = await response.text();
+        return {
+            content: [{ type: "text", text: JSON.stringify(updatedBuild, null, 2) }],
+        };
+    });
 }
 export { BUILD_TOOLS, configureBuildTools };

package/dist/tools/core.js

@@ -1,36 +1,95 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT License.
 import { z } from "zod";
+import { searchIdentities } from "./auth.js";
 const CORE_TOOLS = {
     list_project_teams: "core_list_project_teams",
     list_projects: "core_list_projects",
+    get_identity_ids: "core_get_identity_ids",
 };
-function configureCoreTools(server, tokenProvider, connectionProvider) {
+function filterProjectsByName(projects, projectNameFilter) {
+    const lowerCaseFilter = projectNameFilter.toLowerCase();
+    return projects.filter((project) => project.name?.toLowerCase().includes(lowerCaseFilter));
+}
+function configureCoreTools(server, tokenProvider, connectionProvider, userAgentProvider) {
     server.tool(CORE_TOOLS.list_project_teams, "Retrieve a list of teams for the specified Azure DevOps project.", {
         project: z.string().describe("The name or ID of the Azure DevOps project."),
         mine: z.boolean().optional().describe("If true, only return teams that the authenticated user is a member of."),
         top: z.number().optional().describe("The maximum number of teams to return. Defaults to 100."),
         skip: z.number().optional().describe("The number of teams to skip for pagination. Defaults to 0."),
     }, async ({ project, mine, top, skip }) => {
-        const connection = await connectionProvider();
-        const coreApi = await connection.getCoreApi();
-        const teams = await coreApi.getTeams(project, mine, top, skip, false);
-        return {
-            content: [{ type: "text", text: JSON.stringify(teams, null, 2) }],
-        };
+        try {
+            const connection = await connectionProvider();
+            const coreApi = await connection.getCoreApi();
+            const teams = await coreApi.getTeams(project, mine, top, skip, false);
+            if (!teams) {
+                return { content: [{ type: "text", text: "No teams found" }], isError: true };
+            }
+            return {
+                content: [{ type: "text", text: JSON.stringify(teams, null, 2) }],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : "Unknown error occurred";
+            return {
+                content: [{ type: "text", text: `Error fetching project teams: ${errorMessage}` }],
+                isError: true,
+            };
+        }
     });
     server.tool(CORE_TOOLS.list_projects, "Retrieve a list of projects in your Azure DevOps organization.", {
         stateFilter: z.enum(["all", "wellFormed", "createPending", "deleted"]).default("wellFormed").describe("Filter projects by their state. Defaults to 'wellFormed'."),
         top: z.number().optional().describe("The maximum number of projects to return. Defaults to 100."),
         skip: z.number().optional().describe("The number of projects to skip for pagination. Defaults to 0."),
         continuationToken: z.number().optional().describe("Continuation token for pagination. Used to fetch the next set of results if available."),
-    }, async ({ stateFilter, top, skip, continuationToken }) => {
-        const connection = await connectionProvider();
-        const coreApi = await connection.getCoreApi();
-        const projects = await coreApi.getProjects(stateFilter, top, skip, continuationToken, false);
-        return {
-            content: [{ type: "text", text: JSON.stringify(projects, null, 2) }],
-        };
+        projectNameFilter: z.string().optional().describe("Filter projects by name. Supports partial matches."),
+    }, async ({ stateFilter, top, skip, continuationToken, projectNameFilter }) => {
+        try {
+            const connection = await connectionProvider();
+            const coreApi = await connection.getCoreApi();
+            const projects = await coreApi.getProjects(stateFilter, top, skip, continuationToken, false);
+            if (!projects) {
+                return { content: [{ type: "text", text: "No projects found" }], isError: true };
+            }
+            const filteredProject = projectNameFilter ? filterProjectsByName(projects, projectNameFilter) : projects;
+            return {
+                content: [{ type: "text", text: JSON.stringify(filteredProject, null, 2) }],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : "Unknown error occurred";
+            return {
+                content: [{ type: "text", text: `Error fetching projects: ${errorMessage}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool(CORE_TOOLS.get_identity_ids, "Retrieve Azure DevOps identity IDs for a provided search filter.", {
+        searchFilter: z.string().describe("Search filter (unique namme, display name, email) to retrieve identity IDs for."),
+    }, async ({ searchFilter }) => {
+        try {
+            const identities = await searchIdentities(searchFilter, tokenProvider, connectionProvider, userAgentProvider);
+            if (!identities || identities.value?.length === 0) {
+                return { content: [{ type: "text", text: "No identities found" }], isError: true };
+            }
+            const identitiesTrimmed = identities.value?.map((identity) => {
+                return {
+                    id: identity.id,
+                    displayName: identity.providerDisplayName,
+                    descriptor: identity.descriptor,
+                };
+            });
+            return {
+                content: [{ type: "text", text: JSON.stringify(identitiesTrimmed, null, 2) }],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : "Unknown error occurred";
+            return {
+                content: [{ type: "text", text: `Error fetching identities: ${errorMessage}` }],
+                isError: true,
+            };
+        }
     });
 }
 export { CORE_TOOLS, configureCoreTools };

package/dist/tools/releases.js

@@ -1,21 +1,28 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT License.
-import { ReleaseDefinitionExpands, ReleaseDefinitionQueryOrder, ReleaseExpands, ReleaseStatus, ReleaseQueryOrder, } from "azure-devops-node-api/interfaces/ReleaseInterfaces.js";
+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) {
+function configureReleaseTools(server, _, 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.nativeEnum(ReleaseDefinitionExpands).default(ReleaseDefinitionExpands.None).describe("Expand options for 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.nativeEnum(ReleaseDefinitionQueryOrder).default(ReleaseDefinitionQueryOrder.NameAscending).describe("Order of the results"),
+        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"),
@@ -26,11 +33,9 @@ function configureReleaseTools(server, tokenProvider, connectionProvider) {
     }, 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, expand, artifactType, artifactSourceId, top, continuationToken, queryOrder, path, isExactNameMatch, tagFilter, propertyFilters, definitionIdFilter, isDeleted, searchTextContainsFolderName);
+        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) },
-            ],
+            content: [{ type: "text", text: JSON.stringify(releaseDefinitions, null, 2) }],
         };
     });
     server.tool(RELEASE_TOOLS.get_releases, "Retrieves a list of releases for a given project.", {
@@ -39,18 +44,38 @@ function configureReleaseTools(server, tokenProvider, connectionProvider) {
         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.nativeEnum(ReleaseStatus).optional().default(ReleaseStatus.Active).describe("Status of the releases to filter (default: Active)"),
+        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.date().optional().default(() => {
+        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.date().optional().default(() => new Date()).describe("Maximum created time for releases (default: now)"),
-        queryOrder: z.nativeEnum(ReleaseQueryOrder).optional().default(ReleaseQueryOrder.Ascending).describe("Order in which to return releases (default: Ascending)"),
+        })
+            .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.nativeEnum(ReleaseExpands).optional().default(ReleaseExpands.None).describe("Expand options for releases"),
+        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"),
@@ -63,7 +88,7 @@ function configureReleaseTools(server, tokenProvider, connectionProvider) {
     }, 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, statusFilter, environmentStatusFilter, minCreatedTime, maxCreatedTime, queryOrder, top, continuationToken, expand, artifactTypeId, sourceId, artifactVersionId, sourceBranchFilter, isDeleted, tagFilter, propertyFilters, releaseIdFilter, path);
+        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) }],
         };