Bitbucket Cloud MCP Server

Instructions

Implementation Reference

• src/tools/index.ts:1000-1004 (handler)

  Handler case in ToolHandler.handleTool for the delete_branch tool. Parses arguments using the schema, calls BranchesAPI.delete, and returns a success message.
  case 'delete_branch': { const params = toolSchemas.delete_branch.parse(args); await this.branches.delete(params.workspace, params.repo_slug, params.branch_name); return { success: true, message: 'Branch deleted' }; }
• src/tools/index.ts:169-173 (schema)

  Zod input schema definition for the delete_branch tool in toolSchemas.
  delete_branch: z.object({ workspace: z.string().describe('The workspace slug'), repo_slug: z.string().describe('The repository slug'), branch_name: z.string().describe('The branch name to delete'), }),
• src/tools/index.ts:613-625 (registration)

  Registration of the delete_branch tool in the toolDefinitions array used for MCP, including name, description, and JSON schema for inputs.
  { name: 'delete_branch', description: 'Delete a branch from a repository.', inputSchema: { type: 'object' as const, properties: { workspace: { type: 'string', description: 'The workspace slug' }, repo_slug: { type: 'string', description: 'The repository slug' }, branch_name: { type: 'string', description: 'The branch name to delete' }, }, required: ['workspace', 'repo_slug', 'branch_name'], }, },
• src/api/branches.ts:49-53 (helper)

  Core implementation in BranchesAPI.delete: sends DELETE request to Bitbucket API endpoint to delete the branch.
  async delete(workspace: string, repo_slug: string, branch_name: string): Promise<void> { await this.client.delete( `/repositories/${workspace}/${repo_slug}/refs/branches/${encodeURIComponent(branch_name)}` ); }