Bitbucket Cloud MCP Server

Instructions

Implementation Reference

• src/tools/index.ts:282-286 (schema)

  Zod schema definition for stop_pipeline tool input validation.

  stop_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:832-844 (registration)

  Tool registration in the toolDefinitions array with name, description, and input schema for MCP.

  {
    name: 'stop_pipeline',
    description: 'Stop a running pipeline.',
    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/tools/index.ts:1071-1075 (handler)

  ToolHandler.handleTool case for stop_pipeline: validates args, delegates to PipelinesAPI.stop, returns success.

  case 'stop_pipeline': {
    const params = toolSchemas.stop_pipeline.parse(args);
    await this.pipelines.stop(params.workspace, params.repo_slug, params.pipeline_uuid);
    return { success: true, message: 'Pipeline stopped' };
  }

• src/api/pipelines.ts:59-63 (helper)

  PipelinesAPI.stop: Posts to Bitbucket Pipelines API endpoint to stop the specified pipeline.

  async stop(workspace: string, repo_slug: string, pipeline_uuid: string): Promise<void> {
    await this.client.post(
      `/repositories/${workspace}/${repo_slug}/pipelines/${pipeline_uuid}/stopPipeline`
    );
  }