bitbucket_add_pr_commentLABSCO SUMMARY
The author tells you when not to use the MCP server.
"The bbmd cli should be the superior to MCP when used by AI agents" is in the README, and shipping bbmd skill to teach an agent the CLI backs it up — so the MCP path is really for editors and clients that only speak MCP. Multiple accounts is the practical feature: you can let the agent post PR reviews under a bot identity while your own token stays for your own actions.
What it is
Bitbucket tooling that ships two entry points: bbcp, an MCP server for editors and clients, and bbmd, a direct CLI for humans, scripts and agent workflows. The project states plainly that the CLI is superior to MCP when an AI agent is driving, and provides bbmd skill to teach an agent how to use it.
What you get
- Pull requests read, created and updated —
bitbucket_read_pr,bitbucket_create_pr,bitbucket_update_pr - Review actions —
bitbucket_approve_pr,bitbucket_request_pr_changes,bitbucket_merge_pr - Diffs, both raw and summarised —
bitbucket_get_pr_diff,bitbucket_get_pr_diffstat; file content at a specific commit —bitbucket_get_file_content - Comments added, listed and resolved —
bitbucket_add_pr_comment,bitbucket_list_pr_comments,bitbucket_resolve_pr_comment - Pull request tasks created, listed and updated —
bitbucket_create_pr_task,bitbucket_list_pr_tasks,bitbucket_update_pr_task - Multiple named accounts, so an agent can post reviews as a different identity than yours —
bbmd auth add,bbmd auth status,bbmd auth set-default - A skill file generated for your agent —
bbmd skillwrites to the project-local or global skills folder for Opencode, Claude, Codex or Cursor
Requirements
A Bitbucket API token. Install both binaries with npx --yes @atlacp/install, which places bbmd and bbcp in ~/.atlacp/bin and updates your shell profile — restart the shell afterwards. Configure an account with bbmd auth add --name user --default --token-type Bearer|Basic --token-value "<token>"; an existing atlassian-accounts.json can be copied to ~/.atlacp/accounts.json. The MCP server runs over STDIO with bbcp stdio, or HTTP at http://localhost:8080 and SSE at /sse with bbcp http. A personal API token needs read scopes for account, repository, pullrequest and more, plus write for issue and pullrequest.
Setup effort
One command plus a key — npx --yes @atlacp/install, then supply credentials
USE CASES
01
Reviewing a PR without opening Bitbucket
Read the pull request, pull the diffstat for the shape and the raw diff for the detail, then leave inline comments.
02
Closing out a review round
List the open comment threads, resolve the ones that were addressed, and approve.
03
Turning review feedback into tracked work
Create tasks on the pull request, then list and update them as they get done.
04
Keeping bot reviews off your own account
Add a second named account with its own token and let the agent use it while your default stays yours.
15 tools
Listed in project docs. Your client may show a different list.
bitbucket_approve_prbitbucket_create_prbitbucket_create_pr_taskbitbucket_get_file_contentbitbucket_get_pr_diffbitbucket_get_pr_diffstatbitbucket_list_pr_commentsbitbucket_list_pr_tasksbitbucket_merge_prbitbucket_read_prbitbucket_resolve_pr_commentbitbucket_request_pr_changesbitbucket_update_prbitbucket_update_pr_taskBEFORE YOU INSTALL
What to know first
Tools you get
15 tools named in the project's documentation.
Requires
bbcp on PATH
Where it runs
Both documented setups run the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
npx --yes @atlacp/installMCP Clients
Cursor — stdio
Install the binaries: npx --yes @atlacp/install — it puts bbmd and bbcp in ~/.atlacp/bin and updates your shell profile; restart the shell afterwards
Add your Bitbucket account: bbmd auth add --name user --default --token-type Basic --token-value "<YOUR_TOKEN_VALUE>" for a personal API token, or --token-type Bearer with a repository or workspace access token
Add this to .cursor/mcp.json:
CURSOR — STDIO · JSON
{
"mcpServers": {
"Bitbucket": {
"command": "bbcp",
"args": [
"stdio"
]
}
}
}Cursor — HTTP
Install the binaries: npx --yes @atlacp/install — it puts bbmd and bbcp in ~/.atlacp/bin and updates your shell profile; restart the shell afterwards
Add your Bitbucket account: bbmd auth add --name user --default --token-type Basic --token-value "<YOUR_TOKEN_VALUE>" for a personal API token, or --token-type Bearer with a repository or workspace access token
Start the server and leave it running: bbcp http (it listens on http://localhost:8080)
Add this to .cursor/mcp.json:
CURSOR — HTTP · JSON
{
"mcpServers": {
"Bitbucket": {
"url": "http://localhost:8080"
}
}
}
