list_pipelines
Retrieve pipeline execution history for a Bitbucket Cloud repository to monitor build status, track deployments, and analyze CI/CD workflow performance.
Instructions
List pipeline runs for a repository.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| workspace | Yes | The workspace slug | |
| repo_slug | Yes | The repository slug | |
| page | No | Page number | |
| pagelen | No | Results per page |
Implementation Reference
- src/tools/index.ts:1048-1051 (handler)The main tool handler in ToolHandler.handleTool that parses arguments using the schema and calls PipelinesAPI.list to execute the tool logic.case 'list_pipelines': { const params = toolSchemas.list_pipelines.parse(args); return this.pipelines.list(params); }
- src/tools/index.ts:252-257 (schema)Zod input schema definition for the list_pipelines tool.list_pipelines: z.object({ workspace: z.string().describe('The workspace slug'), repo_slug: z.string().describe('The repository slug'), page: z.number().optional().describe('Page number'), pagelen: z.number().optional().describe('Results per page'), }),
- src/tools/index.ts:774-787 (registration)Tool registration in the toolDefinitions array, including name, description, and inputSchema for MCP protocol.{ name: 'list_pipelines', description: 'List pipeline runs for a repository.', inputSchema: { type: 'object' as const, properties: { workspace: { type: 'string', description: 'The workspace slug' }, repo_slug: { type: 'string', description: 'The repository slug' }, page: { type: 'number', description: 'Page number' }, pagelen: { type: 'number', description: 'Results per page' }, }, required: ['workspace', 'repo_slug'], }, },
- src/api/pipelines.ts:12-21 (helper)PipelinesAPI.list method that performs the actual HTTP GET request to Bitbucket API to list pipelines./** * List pipelines for a repository */ async list(params: ListPipelinesParams): Promise<PaginatedResponse<BitbucketPipeline>> { const { workspace, repo_slug, ...queryParams } = params; return this.client.get<PaginatedResponse<BitbucketPipeline>>( `/repositories/${workspace}/${repo_slug}/pipelines`, queryParams as Record<string, string | number | undefined> ); }
- src/types/index.ts:347-352 (schema)TypeScript interface defining the parameters for list_pipelines.export interface ListPipelinesParams { workspace: string; repo_slug: string; page?: number; pagelen?: number; }