list_pipeline_executions
Retrieve execution history for an AWS CodePipeline to monitor deployment status and track changes.
Instructions
List executions for a specific pipeline
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pipelineName | Yes | Name of the pipeline |
Implementation Reference
- The core handler function for the 'list_pipeline_executions' MCP tool. It takes a pipelineName, calls AWS CodePipeline SDK to list executions, formats the response, and returns it as MCP content.
export async function listPipelineExecutions(codePipelineManager: CodePipelineManager, input: { pipelineName: string }) { const { pipelineName } = input; const codepipeline = codePipelineManager.getCodePipeline(); const response = await codepipeline.listPipelineExecutions({ pipelineName }).promise(); const executions = response.pipelineExecutionSummaries?.map((execution: AWS.CodePipeline.PipelineExecutionSummary) => ({ pipelineExecutionId: execution.pipelineExecutionId || '', status: execution.status || '', startTime: execution.startTime?.toISOString() || '', lastUpdateTime: execution.lastUpdateTime?.toISOString() || '', sourceRevisions: execution.sourceRevisions?.map((revision: AWS.CodePipeline.SourceRevision) => ({ name: revision.actionName || '', revisionId: revision.revisionId || '', revisionUrl: revision.revisionUrl || '', revisionSummary: revision.revisionSummary || '' })) || [] })) || []; return { content: [ { type: "text", text: JSON.stringify({ executions }, null, 2), }, ], }; } - The input schema definition for the 'list_pipeline_executions' tool, specifying the required pipelineName parameter.
export const listPipelineExecutionsSchema = { name: "list_pipeline_executions", description: "List executions for a specific pipeline", inputSchema: { type: "object", properties: { pipelineName: { type: "string", description: "Name of the pipeline" } }, required: ["pipelineName"], }, } as const; - src/index.ts:144-146 (registration)Registration of the tool handler in the MCP CallToolRequestHandler switch statement. Dispatches calls to the listPipelineExecutions function.
case "list_pipeline_executions": { return await listPipelineExecutions(codePipelineManager, input as { pipelineName: string }); } - src/index.ts:115-115 (registration)The tool schema is registered in the ListToolsRequestHandler response, making it discoverable by MCP clients.
listPipelineExecutionsSchema, - src/index.ts:20-22 (registration)Import statement that brings in the handler and schema from the tools directory.
listPipelineExecutions, listPipelineExecutionsSchema } from "./tools/list_pipeline_executions.js";