Bitbucket Cloud MCP Server

Instructions

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;
  }