Bitbucket Cloud MCP Server

Instructions

Implementation Reference

• src/tools/index.ts:1050-1053 (handler)

  MCP tool handler for list_pipelines: parses arguments using Zod schema and delegates to PipelinesAPI.list method.

  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:775-787 (registration)

  Tool registration in MCP toolDefinitions array, including name, description, and JSON schema.

    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:15-21 (helper)

  PipelinesAPI.list method: performs the Bitbucket API GET request to fetch paginated list of pipelines.

  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:349-354 (schema)

  TypeScript interface defining parameters for listing pipelines.

  export interface ListPipelinesParams {
    workspace: string;
    repo_slug: string;
    page?: number;
    pagelen?: number;
  }