pipelines_list_runs
List all pipeline runs in Azure DevOps to track execution history, monitor build status, and analyze performance across multiple organizations.
Instructions
Lists all runs for a specific pipeline
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| organization | Yes | The name of the Azure DevOps organization | |
| project | Yes | Project ID or name to run the build in | |
| pipelineId | Yes | ID of the pipeline to run |
Implementation Reference
- src/tools/pipelines.ts:276-292 (registration)Registration of the 'pipelines_list_runs' MCP tool, including input schema (organization, project, pipelineId) and handler function that retrieves the list of pipeline runs via the Azure DevOps Pipelines API.
server.tool( "pipelines_list_runs", "Lists all runs for a specific pipeline", { organization: z.string().describe("The name of the Azure DevOps organization"), project: z.string().describe("Project ID or name to run the build in"), pipelineId: z.number().describe("ID of the pipeline to run"), }, async ({ organization, project, pipelineId }) => { const connection = await connectionManager.getConnection(organization); const pipelinesApi = await connection.getPipelinesApi(); const pipelineRuns = await pipelinesApi.listRuns(project, pipelineId); return { content: [{ type: "text", text: JSON.stringify(pipelineRuns, null, 2) }], }; } ); - src/tools/pipelines.ts:284-291 (handler)Handler function for 'pipelines_list_runs' tool: connects to Azure DevOps, gets PipelinesApi, calls listRuns(project, pipelineId), and returns JSON stringified list of runs.
async ({ organization, project, pipelineId }) => { const connection = await connectionManager.getConnection(organization); const pipelinesApi = await connection.getPipelinesApi(); const pipelineRuns = await pipelinesApi.listRuns(project, pipelineId); return { content: [{ type: "text", text: JSON.stringify(pipelineRuns, null, 2) }], }; } - src/tools/pipelines.ts:279-283 (schema)Zod input schema for 'pipelines_list_runs' tool defining required parameters: organization (string), project (string), pipelineId (number).
{ organization: z.string().describe("The name of the Azure DevOps organization"), project: z.string().describe("Project ID or name to run the build in"), pipelineId: z.number().describe("ID of the pipeline to run"), },