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
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"organization": "<organization>",
"project": "<project>",
"buildId": "<buildId>"
},
"name": "pipelines_get_build_status"
}
}Input 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) }], }; } );