List Bitbucket pull requests in a repo, filtered by state.

Args: state: OPEN, MERGED, DECLINED, or SUPERSEDED. workspace: Bitbucket workspace slug. repo: Repository slug. limit: Max PRs to return (default 50).

Get a Bitbucket PR's metadata: title, description, author, branches, reviewers, state.

Args: pull_request_id: The PR id (number). workspace: Bitbucket workspace slug. repo: Repository slug.

Get the unified diff for a Bitbucket PR. Returns raw diff text.

Args: pull_request_id: The PR id (number). file_path: Optional file path filter. workspace: Bitbucket workspace slug. repo: Repository slug.

Get the review discussion on a Bitbucket PR (general and inline comments).

Args: pull_request_id: The PR id (number). workspace: Bitbucket workspace slug. repo: Repository slug.

Read a file at a given ref from a Bitbucket repo. Returns raw text.

Args: path: File path within the repo. ref: Branch name or commit hash. workspace: Bitbucket workspace slug. repo: Repository slug.

Get CI/build status for a Bitbucket PR's latest commit.

Args: pull_request_id: The PR id (number). workspace: Bitbucket workspace slug. repo: Repository slug.

Get CI status for a specific commit or branch in Bitbucket.

Args: ref: Commit hash or branch name. workspace: Bitbucket workspace slug. repo: Repository slug.

Create a new Bitbucket pull request.

Args: title: PR title. source_branch: Source branch name. destination_branch: Destination branch name (default "main"). description: PR description (Markdown). reviewers: List of Bitbucket account UUIDs. close_source_branch: Delete source branch after merge. workspace: Bitbucket workspace slug. repo: Repository slug.

List known workspace members to resolve a person's name to their UUID.

Members come from the local known-members directory (see directory.py). Bitbucket's live members API is not used: it requires the account scope the MCP token doesn't carry, so it only ever returned 403. The directory is the single source of truth — seed people into directory.json or the BITBUCKET_KNOWN_MEMBERS env var.

You usually don't need to call this before bb_add_pull_request_reviewers — that tool resolves names against the same directory itself. Use this to inspect who is known, or when a name is ambiguous. If more than one member matches, present the candidates rather than guessing.

Args: query: Optional case-insensitive name filter (display name or nickname). workspace: Bitbucket workspace slug.

Assign reviewers to an existing Bitbucket pull request.

Each entry may be a known member's name (resolved against the local known-members directory) or a raw account UUID. Adds the resolved reviewers to the PR, preserving the existing reviewers unless replace is set. Returns the updated PR detail (its reviewers field confirms the resulting reviewer list).

If any name is unknown or ambiguous, no change is made and the response lists the unresolved entries (with candidates) so you can disambiguate.

Args: pull_request_id: The PR id (number). reviewers: Member names and/or Bitbucket account UUIDs to assign. replace: Replace the reviewer list instead of adding to it. workspace: Bitbucket workspace slug. repo: Repository slug.

Merge a Bitbucket pull request into its destination branch.

Merges the PR and returns the updated PR detail (its state becomes MERGED). The merge fails if the PR is declined, has unresolved merge conflicts, or is blocked by a required merge check (e.g. failing CI or missing approvals) — the error is surfaced in the response.

Args: pull_request_id: The PR id (number). merge_strategy: 'merge_commit', 'squash', or 'fast_forward'. message: Optional custom merge commit message. close_source_branch: Delete the source branch after merge. workspace: Bitbucket workspace slug. repo: Repository slug.

Add a comment to a Bitbucket pull request — general or inline on a specific file/line.

Args: pull_request_id: The PR id (number). content: Comment body (Markdown). inline_path: File path for inline comment. inline_to: Line number in new version. inline_from: Line number in old version. workspace: Bitbucket workspace slug. repo: Repository slug.

Edit the body of an existing Bitbucket pull request comment.

Replaces the comment's content with content and returns the updated comment. Only the comment's author may edit it — editing someone else's comment fails with an authorization error. Get comment ids from bb_get_pull_request_comments.

Args: pull_request_id: The PR id (number). comment_id: The id of the comment to edit. content: New comment body (Markdown), replaces the old one. workspace: Bitbucket workspace slug. repo: Repository slug.

Delete a comment from a Bitbucket pull request.

Permanently removes the comment. Only the comment's author may delete it — deleting someone else's comment fails with an authorization error. Get comment ids from bb_get_pull_request_comments. Returns a confirmation with the deleted comment id.

Args: pull_request_id: The PR id (number). comment_id: The id of the comment to delete. workspace: Bitbucket workspace slug. repo: Repository slug.