build_get_status
Retrieve the status of a specific build in Azure DevOps by providing the project ID or name and build ID using Personal Access Token authentication.
Instructions
Fetches the status of a specific build.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| buildId | Yes | ID of the build to get the status for | |
| project | Yes | Project ID or name to get the build status for |
Implementation Reference
- src/tools/builds.ts:306-314 (handler)Handler function that executes the tool logic: connects to Azure DevOps, retrieves the build API, and fetches the build report (status) for the given project and build ID.
async ({ project, buildId }) => { const connection = await connectionProvider(); const buildApi = await connection.getBuildApi(); const build = await buildApi.getBuildReport(project, buildId); return { content: [{ type: "text", text: JSON.stringify(build, null, 2) }], }; } - src/tools/builds.ts:302-305 (schema)Input schema using Zod for validating project (string) and buildId (number) parameters.
{ 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"), }, - src/tools/builds.ts:299-315 (registration)Registration of the 'build_get_status' tool using server.tool(), mapping from BUILD_TOOLS.get_status, including description, input schema, and handler function.
server.tool( BUILD_TOOLS.get_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 }) => { const connection = await connectionProvider(); const buildApi = await connection.getBuildApi(); const build = await buildApi.getBuildReport(project, buildId); return { content: [{ type: "text", text: JSON.stringify(build, null, 2) }], }; } ); - src/tools/builds.ts:20-20 (registration)Tool name mapping in BUILD_TOOLS constant: get_status -> "build_get_status".
get_status: "build_get_status",