pipelines_get_build_status
Retrieve the current status of a specific Azure DevOps pipeline build to monitor progress, identify failures, or check completion across multiple organizations.
Instructions
Gets the status report for a build
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| organization | Yes | The name of the Azure DevOps organization | |
| project | Yes | Project ID or name to get the build status for | |
| buildId | Yes | ID of the build to get the status for |
Implementation Reference
- src/tools/pipelines.ts:375-382 (handler)Handler function that gets the connection, retrieves the Build API, fetches the build report for the specified project and build ID, and returns the JSON stringified build status.
async ({ organization, project, buildId }) => { const connection = await connectionManager.getConnection(organization); const buildApi = await connection.getBuildApi(); const build = await buildApi.getBuildReport(project, buildId); return { content: [{ type: "text", text: JSON.stringify(build, null, 2) }], }; } - src/tools/pipelines.ts:370-374 (schema)Zod schema defining the input parameters: organization, project, and buildId.
{ organization: z.string().describe("The name of the Azure DevOps organization"), 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/pipelines.ts:367-383 (registration)Registration of the 'pipelines_get_build_status' tool with McpServer, including name, description, input schema, and handler function.
server.tool( "pipelines_get_build_status", "Gets the status report for a build", { organization: z.string().describe("The name of the Azure DevOps organization"), 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 ({ organization, project, buildId }) => { const connection = await connectionManager.getConnection(organization); const buildApi = await connection.getBuildApi(); const build = await buildApi.getBuildReport(project, buildId); return { content: [{ type: "text", text: JSON.stringify(build, null, 2) }], }; } );