create_branch
Create a new branch in Bitbucket Cloud from a specific commit or existing branch to organize development work and isolate changes.
Instructions
Create a new branch from a specific commit or existing branch.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| workspace | Yes | The workspace slug | |
| repo_slug | Yes | The repository slug | |
| name | Yes | New branch name | |
| target | Yes | Target commit hash or branch name |
Implementation Reference
- src/api/branches.ts:35-44 (handler)Core handler function in BranchesAPI that executes the Bitbucket API POST request to create a new branch from the specified target.
async create(params: CreateBranchParams): Promise<BitbucketBranch> { const { workspace, repo_slug, name, target } = params; return this.client.post<BitbucketBranch>( `/repositories/${workspace}/${repo_slug}/refs/branches`, { name, target: { hash: target }, } ); } - src/tools/index.ts:600-612 (registration)Tool registration definition including name, description, and input schema for MCP tool registration.
name: 'create_branch', description: 'Create a new branch from a specific commit or existing branch.', inputSchema: { type: 'object' as const, properties: { workspace: { type: 'string', description: 'The workspace slug' }, repo_slug: { type: 'string', description: 'The repository slug' }, name: { type: 'string', description: 'New branch name' }, target: { type: 'string', description: 'Target commit hash or branch name' }, }, required: ['workspace', 'repo_slug', 'name', 'target'], }, }, - src/tools/index.ts:162-167 (schema)Zod schema used for input validation and parsing in the tool handler.
create_branch: z.object({ workspace: z.string().describe('The workspace slug'), repo_slug: z.string().describe('The repository slug'), name: z.string().describe('New branch name'), target: z.string().describe('Target commit hash or branch name'), }), - src/tools/index.ts:996-999 (handler)Dispatch handler case in ToolHandler.handleTool that parses input and delegates to BranchesAPI.create.
case 'create_branch': { const params = toolSchemas.create_branch.parse(args); return this.branches.create(params); } - src/types/index.ts:313-318 (schema)TypeScript interface defining the input parameters for the create branch operation.
export interface CreateBranchParams { workspace: string; repo_slug: string; name: string; target: string; }