list_pipeline_executions
Retrieve a list of executions for a specific AWS CodePipeline by providing the pipeline name. Use this tool to monitor and analyze pipeline activity.
Instructions
List executions for a specific pipeline
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pipelineName | Yes | Name of the pipeline |
Input Schema (JSON Schema)
{
"properties": {
"pipelineName": {
"description": "Name of the pipeline",
"type": "string"
}
},
"required": [
"pipelineName"
],
"type": "object"
}
Implementation Reference
- The handler function that implements the core logic of the 'list_pipeline_executions' tool, calling AWS CodePipeline API to list executions and formatting the response 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 schema definition for the 'list_pipeline_executions' tool, specifying the input parameters and description.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 server's tool call dispatcher switch statement.case "list_pipeline_executions": { return await listPipelineExecutions(codePipelineManager, input as { pipelineName: string }); }
- src/index.ts:115-115 (registration)Inclusion of the tool schema in the listTools response.listPipelineExecutionsSchema,
- src/index.ts:19-22 (registration)Import of the handler and schema for registration in the MCP server.import { listPipelineExecutions, listPipelineExecutionsSchema } from "./tools/list_pipeline_executions.js";