{"_id":"mcp-bitbucket-dc","_rev":"6-750bc5ce98ff6fa5fe1a01b7fd9a9753","name":"mcp-bitbucket-dc","dist-tags":{"latest":"0.47.1"},"versions":{"0.0.0-stage":{"name":"mcp-bitbucket-dc","version":"0.0.0-stage","_id":"mcp-bitbucket-dc@0.0.0-stage","stub":true,"maintainers":[{"name":"aitani","email":"aitani@tekthar.com"}],"dist":{"shasum":"d2af158697eb222adfcb315eb68410e31b428a09","tarball":"https://registry.npmjs.org/mcp-bitbucket-dc/-/mcp-bitbucket-dc-0.0.0-stage.tgz","fileCount":2,"integrity":"sha512-Wk1S7E1cdZkIETYRWWjbZ0NkDTU9D2PwN1dQiCAAkqyCxu3cV15+BcePiJdFsX+2DfAv/bfOzzltoWzd/uy1sg==","signatures":[{"sig":"MEYCIQDqRF6nX78wGhPsw+wlb82J4Dbe5k/QIt6Cn37tF3Zo6wIhAJyOPyJzvbfxcaUsG839VIRDFa8JHjPD65u7BNq8y6J0","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":338},"_npmUser":{"name":"aitani","email":"aitani@tekthar.com"},"description":"Temporary package placeholder for staged publishing","directories":{}},"0.44.0":{"name":"mcp-bitbucket-dc","version":"0.44.0","keywords":["mcp","mcp-server","model-context-protocol","bitbucket","bitbucket-data-center","bitbucket-server","data-center","atlassian","ai","claude"],"license":"MIT","_id":"mcp-bitbucket-dc@0.44.0","maintainers":[{"name":"aitani","email":"aitani@tekthar.com"}],"homepage":"https://github.com/tekthar/jira-dc-mcp#readme","bugs":{"url":"https://github.com/tekthar/jira-dc-mcp/issues"},"bin":{"mcp-bitbucket-dc":"bin/run.js"},"dist":{"shasum":"08d10229030b5ae19d944d7bb8e517222a50cb50","tarball":"https://registry.npmjs.org/mcp-bitbucket-dc/-/mcp-bitbucket-dc-0.44.0.tgz","fileCount":7,"integrity":"sha512-Xi02xw7fKAg6aLqMjM1lkR7XEC/zRcJHvfudwbcV/r6kQiqm2l0XRNUEmONtMl26xxjB1esoGYlbfMJJmShQ5A==","signatures":[{"sig":"MEUCIQDTu0LJ0CmHflC1fw+CstCGZLJlZKlVcoR8v+8V0PJBrAIgOBckPcyJzJDqFmmkYQ5PreZvQGNEKZQeExu7iukOoeQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIDNa3VckYDuvMpTVeZjFP/jibi9ITQrWyu3s89q/Dz+qAiEArMXRdAzIlU1wZOV67313tvjio+XP1rW3f3nOqWmm878=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":549278},"main":"dist/index.js","type":"module","engines":{"node":">=22.22.2"},"gitHead":"6b2f539fbe7baf70216d8ed6fe5eb5724bf16b14","mcpName":"io.github.tekthar/mcp-bitbucket-dc","private":false,"scripts":{"dev":"nodemon --exec tsx src/index.ts","test":"jest","build":"tsc","start":"node build/index.js","bundle":"node ../../scripts/bundle-server.mjs","inspect":"mcp-inspector node build/index.js","prepack":"tsc --build && npm run bundle","inspect:dev":"mcp-inspector tsx src/index.ts"},"_npmUser":{"name":"aitani","email":"aitani@tekthar.com"},"repository":{"url":"git+https://github.com/tekthar/jira-dc-mcp.git","type":"git","directory":"packages/bitbucket"},"_npmVersion":"10.9.7","description":"MCP server for Bitbucket Data Center and Bitbucket Server: browse projects, repositories, files, branches and commits, search code, and review, comment on and (opt-in) merge pull requests. Not affiliated with Atlassian.","directories":{},"_nodeVersion":"22.22.2","dependencies":{"zod":"4.6.7","dotenv":"18.0.9","@inquirer/prompts":"7.10.1","@modelcontextprotocol/server":"2.4.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"@atlassian-dc-mcp/common":"0.43.2"},"_npmOperationalInternal":{"tmp":"tmp/mcp-bitbucket-dc_0.44.0_1793950840656_0.1289452631217889","host":"s3://npm-registry-packages-npm-production"}},"0.44.1":{"name":"mcp-bitbucket-dc","version":"0.44.1","keywords":["mcp","mcp-server","model-context-protocol","bitbucket","bitbucket-data-center","bitbucket-server","data-center","atlassian","ai","claude"],"license":"MIT","_id":"mcp-bitbucket-dc@0.44.1","maintainers":[{"name":"aitani","email":"aitani@tekthar.com"}],"homepage":"https://github.com/tekthar/jira-dc-mcp#readme","bugs":{"url":"https://github.com/tekthar/jira-dc-mcp/issues"},"bin":{"mcp-bitbucket-dc":"bin/run.js"},"dist":{"shasum":"c961f7d5ffe95dd5ef9339f2544c6058228c49d1","tarball":"https://registry.npmjs.org/mcp-bitbucket-dc/-/mcp-bitbucket-dc-0.44.1.tgz","fileCount":7,"integrity":"sha512-Bk0Qc4ThO9AbKqFe7vcrFo9cmBk9VI1BE67hhnSTEhYXsxzWuAivZnX+W3vzs62PlmULns5RhpUkVczJmjlqhA==","signatures":[{"sig":"MEQCIAj3FvXlcbYMafed3whAxhCK9MfaTY/EI5oa8xAnMprNAiBw/fuDAE+EYCEXIHXiLFEgTc6jHXiKl/cUkRP6t2xFlA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIFJklAKn0xv7UukWh68Yt6WGhfBq2Iq4KP3407N8GJCYAiAmxj8OiUR00PxfrSVZCchcBmtlg42VxjWLHCW30hGQNA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":549278},"main":"dist/index.js","type":"module","engines":{"node":">=22.22.2"},"gitHead":"64f8abb6dd69704417d425f0e4dbe5a725a813d7","mcpName":"io.github.tekthar/mcp-bitbucket-dc","private":false,"scripts":{"dev":"nodemon --exec tsx src/index.ts","test":"jest","build":"tsc","start":"node build/index.js","bundle":"node ../../scripts/bundle-server.mjs","inspect":"mcp-inspector node build/index.js","prepack":"tsc --build && npm run bundle","inspect:dev":"mcp-inspector tsx src/index.ts"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"9241750f-b608-42c4-a2f6-9d00a474b651"}},"repository":{"url":"git+https://github.com/tekthar/jira-dc-mcp.git","type":"git","directory":"packages/bitbucket"},"_npmVersion":"11.21.1","description":"MCP server for Bitbucket Data Center and Bitbucket Server: browse projects, repositories, files, branches and commits, search code, and review, comment on and (opt-in) merge pull requests. Not affiliated with Atlassian.","directories":{},"_nodeVersion":"22.22.2","dependencies":{"zod":"4.6.7","dotenv":"18.0.9","@inquirer/prompts":"7.10.1","@modelcontextprotocol/server":"2.4.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"@atlassian-dc-mcp/common":"0.43.2"},"_npmOperationalInternal":{"tmp":"tmp/mcp-bitbucket-dc_0.44.1_1793952913540_0.05318800497023746","host":"s3://npm-registry-packages-npm-production"}},"0.45.0":{"name":"mcp-bitbucket-dc","version":"0.45.0","keywords":["mcp","mcp-server","model-context-protocol","bitbucket","bitbucket-data-center","bitbucket-server","data-center","atlassian","ai","claude"],"license":"MIT","_id":"mcp-bitbucket-dc@0.45.0","maintainers":[{"name":"aitani","email":"aitani@tekthar.com"}],"homepage":"https://github.com/tekthar/jira-dc-mcp#readme","bugs":{"url":"https://github.com/tekthar/jira-dc-mcp/issues"},"bin":{"mcp-bitbucket-dc":"bin/run.js"},"dist":{"shasum":"49dd34e91c2f3fdca67790fe13c3e75e64c3d10a","tarball":"https://registry.npmjs.org/mcp-bitbucket-dc/-/mcp-bitbucket-dc-0.45.0.tgz","fileCount":7,"integrity":"sha512-xWhedcEh6MYDiJITkRolYxyI+GyX/zNuUs85IhZfINGoCMn4E9QQPVI11uJMLgcu21iyqhfOAJen3v1y77nmsQ==","signatures":[{"sig":"MEYCIQCr9O4cN681evRangU51QL1Rq+Jq8hhn0rDpsjzyK/WqQIhANs/6oVbG7N5wm3DLKtvTR1S4wzhMOg9OQ/cJ1XxiYQV","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIFJ3Sd3VsrG9VAgzIVKowevMebBBRrZnouZyw/l75ia6AiEArWBz6YoVsIHBYlu45tKRh1bLs9qqtjjQ5bbQeAxw94E=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":556438},"main":"dist/index.js","type":"module","engines":{"node":">=22.22.2"},"gitHead":"aff0e2d3e575bbfd12da2aec96381ce9c6133fa3","mcpName":"io.github.tekthar/mcp-bitbucket-dc","private":false,"scripts":{"dev":"nodemon --exec tsx src/index.ts","test":"jest","build":"tsc","start":"node build/index.js","bundle":"node ../../scripts/bundle-server.mjs","inspect":"mcp-inspector node build/index.js","prepack":"tsc --build && npm run bundle","inspect:dev":"mcp-inspector tsx src/index.ts"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"9241750f-b608-42c4-a2f6-9d00a474b651"}},"repository":{"url":"git+https://github.com/tekthar/jira-dc-mcp.git","type":"git","directory":"packages/bitbucket"},"_npmVersion":"11.21.1","description":"MCP server for Bitbucket Data Center and Bitbucket Server: browse projects, repositories, files, branches and commits, search code, and review, comment on and (opt-in) merge pull requests. Not affiliated with Atlassian.","directories":{},"_nodeVersion":"22.22.2","dependencies":{"zod":"4.6.7","dotenv":"18.0.9","@inquirer/prompts":"7.10.1","quickjs-emscripten-core":"0.32.0","@modelcontextprotocol/server":"2.4.0","@jitl/quickjs-wasmfile-release-sync":"0.32.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"@atlassian-dc-mcp/common":"0.43.2"},"_npmOperationalInternal":{"tmp":"tmp/mcp-bitbucket-dc_0.45.0_1793969649106_0.9307190752163677","host":"s3://npm-registry-packages-npm-production"}},"0.47.0":{"name":"mcp-bitbucket-dc","version":"0.47.0","keywords":["mcp","mcp-server","model-context-protocol","bitbucket","bitbucket-data-center","bitbucket-server","data-center","atlassian","ai","claude"],"license":"MIT","_id":"mcp-bitbucket-dc@0.47.0","maintainers":[{"name":"aitani","email":"aitani@tekthar.com"}],"homepage":"https://github.com/tekthar/atlassian-data-center-mcp#readme","bugs":{"url":"https://github.com/tekthar/atlassian-data-center-mcp/issues"},"bin":{"mcp-bitbucket-dc":"bin/run.js"},"dist":{"shasum":"85ecf0f12e2db5d4c01cf65452d3c5bfae08ed6a","tarball":"https://registry.npmjs.org/mcp-bitbucket-dc/-/mcp-bitbucket-dc-0.47.0.tgz","fileCount":11,"integrity":"sha512-4VppQXJ10qnVGrdxg3xBoK9YMoA6Vbm1qMXEkkbSA1aaQs6P2RKLNKI/ftslTUFLHiGrQHnYJhkb7bOovgK6mA==","signatures":[{"sig":"MEQCIH6b4HPQhMrhGZMZvgVA/wzxza3nwNVHgbOEdU+jY2CZAiAi24DH63VRwd5/JSsWEoqE+sV8TJY/Q1wY0F6ccbNxrA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIF0MofUf19Frx7YaiKQvySY+sRTZFGCIpoGAipgJWEBbAiBvw7CieW08o2BBuBiUoLhLaMHKNUYebelmLZq+fZLCog==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/mcp-bitbucket-dc@0.47.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":582927},"main":"dist/index.js","type":"module","engines":{"node":">=22.22.2"},"gitHead":"e6d9d1145fd74c0fd3cf8026246cb965fd50ff9e","mcpName":"io.github.tekthar/mcp-bitbucket-dc","private":false,"scripts":{"dev":"nodemon --exec tsx src/index.ts","test":"jest","build":"tsc","start":"node build/index.js","bundle":"node ../../scripts/bundle-server.mjs","inspect":"mcp-inspector node build/index.js","prepack":"tsc --build && npm run bundle","inspect:dev":"mcp-inspector tsx src/index.ts"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"1b5603ad-007c-4a8e-bbb3-7bfdf7459591"}},"repository":{"url":"git+https://github.com/tekthar/atlassian-data-center-mcp.git","type":"git","directory":"packages/bitbucket"},"_npmVersion":"11.21.1","description":"MCP server for Bitbucket Data Center and Bitbucket Server: browse projects, repositories, files, branches and commits, search code, and review, comment on and (opt-in) merge pull requests. Not affiliated with Atlassian.","directories":{},"_nodeVersion":"22.22.2","dependencies":{"zod":"4.6.7","dotenv":"18.0.9","@napi-rs/keyring":"2.1.2","@inquirer/prompts":"7.10.1","quickjs-emscripten-core":"0.32.0","@modelcontextprotocol/server":"2.4.0","@jitl/quickjs-wasmfile-release-sync":"0.32.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"@atlassian-dc-mcp/common":"0.43.2"},"_npmOperationalInternal":{"tmp":"tmp/mcp-bitbucket-dc_0.47.0_1794002664517_0.7804620915088989","host":"s3://npm-registry-packages-npm-production"}},"0.47.1":{"_id":"mcp-bitbucket-dc@0.47.1","bin":{"mcp-bitbucket-dc":"bin/run.js"},"bugs":{"url":"https://github.com/tekthar/atlassian-data-center-mcp/issues"},"dist":{"shasum":"a9caca53f1f3ba0b98dfb62a85d7383e661ff102","tarball":"https://registry.npmjs.org/mcp-bitbucket-dc/-/mcp-bitbucket-dc-0.47.1.tgz","fileCount":11,"integrity":"sha512-ks4Tc+uTxz+jFBznrUx6QVkNNx5mQUMDruN6PCXr5ERig7zghJqXDH/1zhNeF7kL4aQQDei5+ts3GN9mX+29/Q==","signatures":[{"sig":"MEQCIHs/YPb0DFqOXBsOrFQt8rUV99B6U7tsiPAohCs5I5j4AiAew/VimkO8czT8qC9DhshIxzlSnMH6bx+FJL89v5VD7Q==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIBAYt+FvfSF9fH5eNWnrbh4ZDX9FQjSZcZuPrQn2inbZAiAynAdTYgB0gVyQgTtavmDgtuLMNJm/CGoJ0k7MQYBAmQ=="}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/mcp-bitbucket-dc@0.47.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":583610},"main":"dist/index.js","name":"mcp-bitbucket-dc","type":"module","engines":{"node":">=22.22.2"},"gitHead":"027433c1b737a9e56733e29303e5bf7f4bbe2d03","license":"MIT","mcpName":"io.github.tekthar/mcp-bitbucket-dc","private":false,"scripts":{"dev":"nodemon --exec tsx src/index.ts","test":"jest","build":"tsc","start":"node build/index.js","bundle":"node ../../scripts/bundle-server.mjs","inspect":"mcp-inspector node build/index.js","prepack":"tsc --build && npm run bundle","inspect:dev":"mcp-inspector tsx src/index.ts"},"version":"0.47.1","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"1b5603ad-007c-4a8e-bbb3-7bfdf7459591"}},"homepage":"https://github.com/tekthar/atlassian-data-center-mcp#readme","keywords":["mcp","mcp-server","model-context-protocol","bitbucket","bitbucket-data-center","bitbucket-server","data-center","atlassian","ai","claude"],"repository":{"url":"git+https://github.com/tekthar/atlassian-data-center-mcp.git","type":"git","directory":"packages/bitbucket"},"_npmVersion":"11.21.1","description":"MCP server for Bitbucket Data Center and Bitbucket Server: browse projects, repositories, files, branches and commits, search code, and review, comment on and (opt-in) merge pull requests. Not affiliated with Atlassian.","directories":{},"maintainers":[{"name":"aitani","email":"aitani@tekthar.com"}],"_nodeVersion":"22.22.2","dependencies":{"zod":"4.6.7","dotenv":"18.0.9","@napi-rs/keyring":"2.1.2","@inquirer/prompts":"7.10.1","quickjs-emscripten-core":"0.32.0","@modelcontextprotocol/server":"2.4.0","@jitl/quickjs-wasmfile-release-sync":"0.32.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"@atlassian-dc-mcp/common":"0.43.2"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-bitbucket-dc_0.47.1_1794004783048_0.27542098952694094"}}},"time":{"created":"2026-11-06T07:39:23.914Z","modified":"2026-11-06T22:39:43.588Z","0.0.0-stage":"2026-11-06T07:39:23.914Z","0.44.0":"2026-11-06T07:40:40.761Z","0.44.1":"2026-11-06T08:15:13.708Z","0.45.0":"2026-11-06T12:54:09.251Z","0.47.0":"2026-11-06T22:04:24.642Z","0.47.1":"2026-11-06T22:39:43.254Z"},"bugs":{"url":"https://github.com/tekthar/atlassian-data-center-mcp/issues"},"license":"MIT","homepage":"https://github.com/tekthar/atlassian-data-center-mcp#readme","keywords":["mcp","mcp-server","model-context-protocol","bitbucket","bitbucket-data-center","bitbucket-server","data-center","atlassian","ai","claude"],"repository":{"url":"git+https://github.com/tekthar/atlassian-data-center-mcp.git","type":"git","directory":"packages/bitbucket"},"description":"MCP server for Bitbucket Data Center and Bitbucket Server: browse projects, repositories, files, branches and commits, search code, and review, comment on and (opt-in) merge pull requests. Not affiliated with Atlassian.","maintainers":[{"name":"aitani","email":"aitani@tekthar.com"}],"readme":"# mcp-bitbucket-dc\n\n**Connect Claude, Cursor and any other MCP client to Bitbucket Data Center and Bitbucket Server, signed in as you.**\n\nThe server runs on your machine. Your MCP client starts it and talks to it over stdio; it calls Bitbucket's REST API\nwith your HTTP access token, so the agent can browse repositories, search code and review pull requests. Bitbucket's\nown permissions decide what you can do, and merging stays off until you allow it for the repositories you name.\n\n```bash\nnpx -y mcp-bitbucket-dc setup                         # saves your Bitbucket address and token\nclaude mcp add bitbucket -- npx -y mcp-bitbucket-dc   # connects Claude Code\n```\n\n> Not affiliated with or endorsed by Atlassian. Bitbucket is a trademark of Atlassian.\n\n## Why run it on your machine?\n\n| | A hosted MCP connector | **mcp-bitbucket-dc** |\n|---|---|---|\n| Works with Bitbucket Data Center and Server | depends on the service | **yes** |\n| Reaches a Bitbucket behind your firewall or VPN | only if Bitbucket is exposed to the service | **yes**: wherever your machine can reach |\n| Where your token lives | with the service | **on your machine**: your OS keychain, or a file only your user can read |\n| Merges limited to repositories and branches you name | depends on the service | **yes** |\n| Something to host, approve or pay for | the service | **nothing**: `npx` runs it |\n\n[Atlassian's official MCP server](https://github.com/atlassian/atlassian-mcp-server) is a hosted server for Atlassian\nCloud.\n\n## Install\n\nYou need Node.js 22.22.2 or later, Bitbucket Data Center or Bitbucket Server, and an HTTP access token. To create one,\nopen your profile picture in Bitbucket, then **Manage account** > **HTTP access tokens** > **Create token**.\n\n**1. Save your address and token.** `setup` asks for them, checks them with one request to Bitbucket, and saves them:\n\n```bash\nnpx -y mcp-bitbucket-dc setup\n```\n\nThe token goes to your OS keychain: the macOS Keychain, Windows Credential Manager, or on Linux the desktop\nkeyring (GNOME Keyring or KWallet). Everything else goes to `~/.atlassian-dc-mcp/bitbucket.env`\n(`%USERPROFILE%\\.atlassian-dc-mcp\\bitbucket.env` on Windows), which only your user can read. Without a keychain, such as\non a Linux server, the token goes in that file too.\n\n**2. Connect your client.** `install` registers the server with Claude Code or Claude Desktop for you:\n\n```bash\nnpx -y mcp-bitbucket-dc install --claude-code      # runs claude mcp add\nnpx -y mcp-bitbucket-dc install --claude-desktop   # edits Claude Desktop's config, after backing it up\n```\n\nCursor, VS Code and other clients with an `mcpServers` file:\n\n```json\n{\n  \"mcpServers\": {\n    \"bitbucket\": { \"command\": \"npx\", \"args\": [\"-y\", \"mcp-bitbucket-dc\"] }\n  }\n}\n```\n\nTo skip `setup`, put the settings in that entry instead:\n`\"env\": { \"BITBUCKET_HOST\": \"bitbucket.example.com\", \"BITBUCKET_API_TOKEN\": \"<HTTP access token>\" }`.\n\n## Commands\n\n| Command | Does |\n|---|---|\n| `npx -y mcp-bitbucket-dc` | Serves Bitbucket over stdio. This is what your MCP client runs. |\n| `npx -y mcp-bitbucket-dc setup` | Asks for your address and token, checks them against Bitbucket, and saves them. |\n| `setup --non-interactive --host <host> --token <token>` | The same from flags, for scripts and CI. Exits non-zero if the token doesn't work. Values you leave out come from your existing settings. |\n| `setup --help` | Lists every option. |\n| `npx -y mcp-bitbucket-dc install --claude-code [--scope user\\|project\\|local]` | Registers the server with Claude Code by running `claude mcp add`. |\n| `npx -y mcp-bitbucket-dc install --claude-desktop` | Adds the server to Claude Desktop's configuration, after backing it up. |\n| `npx -y mcp-bitbucket-dc doctor` | Checks Node.js, where each setting comes from, the keychain, signing in, and the tools your client will see, and says how to fix what's wrong. The token is masked. |\n\n## Tools\n\n27 tools, plus 2 for merging and declining that stay off until you allow them.\n\n| Area | Tools |\n|---|---|\n| Projects and repositories | `bitbucket_getProjects`, `bitbucket_getProject`, `bitbucket_getRepositories`, `bitbucket_getRepository`, `bitbucket_browseRepository`, `bitbucket_getFileContent`, `bitbucket_searchCode` |\n| Branches and commits | `bitbucket_createBranch`, `bitbucket_getCommits`, `bitbucket_getBranchDiff` |\n| Reading pull requests | `bitbucket_getPullRequests`, `bitbucket_getPullRequest`, `bitbucket_getPR_CommentsAndAction`, `bitbucket_getPullRequestChanges`, `bitbucket_getPullRequestDiff`, `bitbucket_getPullRequestBuilds`, `bitbucket_canMergePullRequest`, `bitbucket_getRequiredReviewers`, `bitbucket_getInboxPullRequests`, `bitbucket_getDashboardPullRequests` |\n| Working on pull requests | `bitbucket_createPullRequest`, `bitbucket_updatePullRequest`, `bitbucket_postPullRequestComment`, `bitbucket_updatePullRequestComment`, `bitbucket_submitPullRequestReview`, `bitbucket_reopenPullRequest` |\n| Users | `bitbucket_getUser` |\n| Off until you allow them | `bitbucket_mergePullRequest`, `bitbucket_declinePullRequest` |\n\n`bitbucket_getPR_CommentsAndAction` and `bitbucket_getPullRequestChanges` take `output=summary|compact|full`. The\ndefault is `compact`.\n\n## Supported apps\n\nNo Bitbucket apps (Marketplace plugins) are supported yet. The Jira server, `mcp-jira-dc`, has tools for Xray and Jira\nService Management; [Supported apps](https://github.com/tekthar/atlassian-data-center-mcp/blob/main/docs/supported-apps.md) lists them with the versions they were built from.\n\n## Settings\n\nEvery setting is an environment variable. Each comes from the first of these that has it: the environment, the dotenv\nfile named by `ATLASSIAN_DC_MCP_CONFIG_FILE`, the file `setup` writes, then the OS\nkeychain.\n\n**Connecting**\n\n| Variable | Use |\n|---|---|\n| `BITBUCKET_HOST` | Host name and optional port, without `https://`, e.g. `bitbucket.example.com`. |\n| `BITBUCKET_API_BASE_PATH` | Full REST base URL, used instead of `BITBUCKET_HOST`, e.g. `https://example.com/bitbucket/rest`. |\n| `BITBUCKET_API_TOKEN` | HTTP access token. |\n| `BITBUCKET_DEFAULT_PAGE_SIZE` | Page size for list tools. Default 25. |\n| `ATLASSIAN_DC_MCP_CONFIG_FILE` | Absolute path to a dotenv file with any of these settings, e.g. one file shared by several servers. |\n| `ATLASSIAN_DC_MCP_REQUEST_TIMEOUT_MS` | How long a request to Bitbucket may take. Default 30000. |\n| `ATLASSIAN_DC_MCP_KEYCHAIN` | `off` keeps the token out of the OS keychain: `setup` saves it in the file instead, and the server doesn't look in the keychain. |\n\n**Merging and declining pull requests**\n\nBoth tools stay unlisted until you turn them on and name the repositories they may act on. The agent can't widen that\nlist.\n\n| Variable | Use |\n|---|---|\n| `BITBUCKET_MERGE_ENABLED` | `true` lists `bitbucket_mergePullRequest`. |\n| `BITBUCKET_MERGE_ALLOWED_REPOS` | Required for merging. `PROJECT/repo` entries, comma-separated. `PROJECT/*` allows a whole project. |\n| `BITBUCKET_MERGE_ALLOWED_TARGET_REFS` | Optional. Branches that may be merged into, such as `develop,refs/heads/release/*`. |\n| `BITBUCKET_DECLINE_ENABLED` | `true` lists `bitbucket_declinePullRequest`. |\n| `BITBUCKET_DECLINE_ALLOWED_REPOS` | Required for declining. Same format as for merging. |\n\n**Audit log**\n\n| Variable | Use |\n|---|---|\n| `ATLASSIAN_DC_MCP_AUDIT` | `1` writes one JSON line per tool call: the time, server, tool, outcome and duration, never the arguments or results. |\n| `ATLASSIAN_DC_MCP_AUDIT_FILE` | Where to write it. Default `~/.atlassian-dc-mcp/audit/mcp-bitbucket-dc.jsonl` (mode 0600 on macOS and Linux). It rotates at 5 MB, keeping three old files. |\n\n## What it guarantees\n\n- **It never widens access.** Every request carries your token, so Bitbucket decides what you can do.\n- **Writes stay visible.** Read tools are marked read-only, so your client can tell them apart and ask you before\n  anything else runs.\n- **Merges stay under your control.** Before anything is written, a merge is checked against the repositories and\n  target branches you allowed. It must also pass Bitbucket's own merge checks: conflicts, required approvals, open\n  tasks and builds.\n- **Nothing changes behind your back.** Merging and declining need the pull request's current `version`, so a pull\n  request that changed after the agent looked at it is rejected. `bitbucket_reopenPullRequest` undoes a decline.\n- **It never retries a call on its own.** If a request fails, the agent sees Bitbucket's error and decides what to do.\n\nFile contents, diffs, commit messages and comments are written by other people, so treat them as data, not\ninstructions.\n\n## Related projects\n\n- [mcp-jira-dc](https://www.npmjs.com/package/mcp-jira-dc) and\n  [mcp-confluence-dc](https://www.npmjs.com/package/mcp-confluence-dc): the same approach for Jira and Confluence Data\n  Center.\n\n## Acknowledgments\n\nmcp-bitbucket-dc builds on [b1ff/atlassian-dc-mcp](https://github.com/b1ff/atlassian-dc-mcp) (MIT). Its copyright notice\nis in [LICENSE](LICENSE), together with those of the other projects this code shares parts with.\n\n## License\n\nMIT. Part of [Atlassian Data Center MCP](https://github.com/tekthar/atlassian-data-center-mcp), with\n[mcp-jira-dc](https://www.npmjs.com/package/mcp-jira-dc) and\n[mcp-confluence-dc](https://www.npmjs.com/package/mcp-confluence-dc).\n","readmeFilename":"README.md"}