mcp-server-bitbucket

Instructions

Args:
    repo_slug: Repository slug (e.g., "anzsic_classifier")
    title: PR title
    source_branch: Source branch name
    destination_branch: Target branch (default: main)
    description: PR description in markdown
    close_source_branch: Delete source branch after merge (default: True)

Returns:
    Created PR info with id, url, and state

Implementation Reference

• src/server.py:210-249 (handler)

  MCP tool handler function for 'create_pull_request', decorated with @mcp.tool() for registration. It validates inputs, calls the Bitbucket client helper, and formats the response.

  @mcp.tool()
  @handle_bitbucket_error
  @formatted
  def create_pull_request(
      repo_slug: str,
      title: str,
      source_branch: str,
      destination_branch: str = "main",
      description: str = "",
      close_source_branch: bool = True,
  ) -> dict:
      """Create a pull request in a Bitbucket repository.
  
      Args:
          repo_slug: Repository slug (e.g., "anzsic_classifier")
          title: PR title
          source_branch: Source branch name
          destination_branch: Target branch (default: main)
          description: PR description in markdown
          close_source_branch: Delete source branch after merge (default: True)
  
      Returns:
          Created PR info with id, url, and state
      """
      client = get_client()
      result = client.create_pull_request(
          repo_slug=repo_slug,
          title=title,
          source_branch=source_branch,
          destination_branch=destination_branch,
          description=description,
          close_source_branch=close_source_branch,
      )
      return {
          "id": result.get("id"),
          "title": result.get("title"),
          "state": result.get("state"),
          "url": client.extract_pr_url(result),
      }

• src/bitbucket_client.py:384-430 (helper)

  Core helper method in BitbucketClient class that constructs the API payload and makes the POST request to create the pull request.

  def create_pull_request(
      self,
      repo_slug: str,
      title: str,
      source_branch: str,
      destination_branch: str = "main",
      description: str = "",
      close_source_branch: bool = True,
      reviewers: Optional[list[str]] = None,
  ) -> dict[str, Any]:
      """Create a pull request.
  
      Args:
          repo_slug: Repository slug
          title: PR title
          source_branch: Source branch name
          destination_branch: Target branch (default: main)
          description: PR description body
          close_source_branch: Delete branch after merge
          reviewers: List of reviewer account IDs (optional)
  
      Returns:
          Dict with PR info including 'id', 'links', 'state'
      """
      payload = {
          "title": title,
          "source": {"branch": {"name": source_branch}},
          "destination": {"branch": {"name": destination_branch}},
          "close_source_branch": close_source_branch,
      }
      if description:
          payload["description"] = description
      if reviewers:
          # Handle both UUID format and account_id format
          payload["reviewers"] = [
              {"uuid": r} if r.startswith("{") else {"account_id": r}
              for r in reviewers
          ]
  
      result = self._request(
          "POST",
          self._repo_path(repo_slug, "pullrequests"),
          json=payload,
      )
      return self._require_result(
          result, "create PR", f"{source_branch} -> {destination_branch}"
      )