Bitbucket Cloud MCP Server

Instructions

Implementation Reference

• src/tools/index.ts:1054-1057 (handler)

  The MCP tool handler case for 'get_pipeline' that validates arguments with Zod schema and calls PipelinesAPI.get to retrieve pipeline details.

  case 'get_pipeline': {
    const params = toolSchemas.get_pipeline.parse(args);
    return this.pipelines.get(params.workspace, params.repo_slug, params.pipeline_uuid);
  }

• src/tools/index.ts:259-263 (schema)

  Zod input schema definition for the 'get_pipeline' tool.

  get_pipeline: z.object({
    workspace: z.string().describe('The workspace slug'),
    repo_slug: z.string().describe('The repository slug'),
    pipeline_uuid: z.string().describe('The pipeline UUID'),
  }),

• src/tools/index.ts:788-800 (registration)

  Tool registration in the toolDefinitions export array used by MCP, including name, description, and JSON schema.

  {
    name: 'get_pipeline',
    description: 'Get details of a specific pipeline run.',
    inputSchema: {
      type: 'object' as const,
      properties: {
        workspace: { type: 'string', description: 'The workspace slug' },
        repo_slug: { type: 'string', description: 'The repository slug' },
        pipeline_uuid: { type: 'string', description: 'The pipeline UUID' },
      },
      required: ['workspace', 'repo_slug', 'pipeline_uuid'],
    },
  },

• src/api/pipelines.ts:26-34 (helper)

  PipelinesAPI.get method implementation that performs the HTTP GET request to Bitbucket's pipeline endpoint.

  async get(
    workspace: string,
    repo_slug: string,
    pipeline_uuid: string
  ): Promise<BitbucketPipeline> {
    return this.client.get<BitbucketPipeline>(
      `/repositories/${workspace}/${repo_slug}/pipelines/${pipeline_uuid}`
    );
  }