Bitbucket MCP Server by pdogra1299: Setup for Claude, Cursor and Other Apps

• Searches file contents in a repo with regex

  Searches a repo's files with a full regular expression on any branch, like ripgrep on a local clone. It downloads one archive per repo and commit, and works only on Bitbucket Server or Data Center. Leave out the query to list file names by glob.

  Try: “Find every use of parseConfig in the payments repo on the release branch.”

  Network · grep

• Searches a whole project for an exact term

  Looks up an exact term across all repos in a project using Bitbucket's index. It covers the default branch only, has no regex, and works only on Server or Data Center.

  Try: “Which repos in PROJ mention LEGACY_AUTH_FLAG?”

  Network · search_code

• Finds repositories by name or description

  Searches the whole Bitbucket instance for repos by name or description. Server or Data Center only.

  Try: “Find repositories about invoice export.”

  Network · search_repositories

• Lists projects or workspaces you can see

  Lists the projects (Server) or workspaces (Cloud) your account can access.

  Try: “Which Bitbucket projects can I see?”

  Network · list_projects

• Lists repositories in a project

  Lists repos in one project, or every repo you can access on Server.

  Try: “List the repos in project PAY.”

  Network · list_repositories

• Shows a pull request in full

  Returns details, reviewer status, merge info, comments and changed files for a pull request. You can switch comments and files off for a quick read, or add tasks.

  Try: “Summarize PR 482 in the billing repo, including open tasks.”

  Network · get_pull_request

• Lists pull requests

  Lists pull requests in a repo. On Server, leave out the repo to see your own pull requests across all repos, filtered by your role.

  Try: “Show the pull requests I need to review.”

  Network · list_pull_requests

• Reads a pull request's changes

  Returns the raw unified diff for a pull request. You can limit it to one file, include or exclude patterns, change context lines or ignore whitespace.

  Try: “Show me the diff for src/auth in PR 482.”

  Network · get_pull_request_diff

• Lists commits in a pull request

  Lists the commits that make up a pull request.

  Try: “Which commits are in PR 482?”

  Network · list_pr_commits

• Lists commits on a branch

  Lists commits on a branch, with filters for merges, an earlier revision, author, date and text.

  Try: “What did Priya commit to release/2.4 this week?”

  Network · list_branch_commits

• Shows one commit

  Returns a commit's diff, or only the list of changed files if you ask for detail "files".

  Try: “Which files changed in commit a1b2c3d?”

  Network · get_commit_detail

• Lists branches

  Lists branches, most recently changed first on Server.

  Try: “Which branches changed most recently in checkout-service?”

  Network · list_branches

• Shows a branch and its pull requests

  Returns a branch with its latest commit and open pull requests, and merged ones if you ask.

  Try: “Is there an open PR for feature/refund-flow?”

  Network · get_branch

• Lists files in a repo folder

  Lists files and folders at a path in a repository.

  Try: “What is in the src/services folder?”

  Network · list_directory_content

• Reads a file or a window of it

  Reads a file from the repo. By default it transfers only the lines you ask for (up to 5,000 per call), and it can return the whole file or the tail.

  Try: “Show lines 120 to 200 of OrderService.java on main.”

  Network · get_file_content

• Shows who last changed each line

  Returns commit-span blame for a window of lines in one call. Server or Data Center only.

  Try: “Who last changed lines 40 to 80 of PaymentRouter.kt?”

  Network · get_file_blame

• Opens a pull request

  Creates a pull request from a source branch to a destination branch.

  Try: “Open a PR from feature/refund-flow to main titled "Add refund flow".”

  Write · create_pull_request

• Edits a pull request

  Changes a pull request's details such as title, description or reviewers.

  Try: “Add Sam as a reviewer on PR 482.”

  Write · update_pull_request

• Comments on a pull request

  Adds a general comment, a threaded reply, an inline comment on a line, a code suggestion, or a blocker task. On Server it can attach files, but only from a folder you allow.

  Try: “Comment on line 42 of auth.ts in PR 482: this needs a null check.”

  Write · add_comment

• Edits, resolves or deletes comments

  Edits, deletes, resolves or reopens a comment or task, and on Server converts between a comment and a task. It is marked destructive.

  Try: “Resolve the comment thread on line 42.”

  Delete · manage_comment

• Approves or requests changes

  Sets your review status on a pull request to approved, needs work or unapproved.

  Try: “Approve PR 482.”

  Write · set_review_status

• Merges a pull request

  Merges a pull request into its destination branch. You can list protected branches that it must refuse to merge into.

  Try: “Merge PR 482.”

  Write · merge_pull_request

• Declines a pull request

  Declines a pull request, with an optional comment.

  Try: “Decline PR 480 and say it is superseded by 482.”

  Write · decline_pull_request

• Deletes a branch

  Deletes a branch from the repo. The protected-branches setting can block it for named branches.

  Try: “Delete the merged branch feature/old-login.”

  Delete · delete_branch

• Downloads or deletes an attachment

  Downloads (size-capped) or deletes a repository attachment by its number. Server only. Deletion is refused in read-only mode.

  Try: “Download attachment 17 from the docs repo.”

  Delete · manage_attachments

Watch out for

• It can merge pull requests and delete branches

  By default the assistant can merge or decline pull requests and delete branches, comments and attachments with the permissions of your token. Set BITBUCKET_READ_ONLY=true, and use BITBUCKET_PROTECTED_BRANCHES to block merges and deletes on main and release branches. github.com

• It acts as you, with your token

  Approvals, comments and merges are made under your username. Use a token for a service account with only the repos it needs. github.com

• Attachment uploads read local files, off by default

  Uploads stay refused until you set BITBUCKET_ATTACHMENT_ROOT, and then can read only regular files inside that folder. github.com

• Read-only mode still allows attachment downloads

  Attachment downloads keep working under BITBUCKET_READ_ONLY, with a size cap. Deletion is refused. github.com

Security advisories