bitbucket-datacenter-mcp 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,307 @@
+# Change Log
+
+## 0.2.0
+
+### Minor Changes
+
+- [`582a094`](https://github.com/MrRefactoring/atlassian-dc-mcp/commit/582a094960ba6d74453aabefa4ed44522ac07351) Thanks [@MrRefactoring](https://github.com/MrRefactoring)! - Allow the MCP servers to start and run without an API token, for Data Center instances that permit anonymous access. `*_API_TOKEN` is no longer required by config validation or the interactive `setup` CLI; when it's absent, requests are sent with no `Authorization` header instead of the previous placeholder-token workaround.
+
+### Patch Changes
+
+- Updated dependencies [[`582a094`](https://github.com/MrRefactoring/atlassian-dc-mcp/commit/582a094960ba6d74453aabefa4ed44522ac07351)]:
+  - datacenter-mcp-core@0.2.0
+
+All notable changes to this project will be documented in this file.
+See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+# [0.25.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.24.0...v0.25.0) (2026-06-18)
+
+### Features
+
+- **bitbucket:** support posting comments as tasks and updating comments ([e278f47](https://github.com/b1ff/atlassian-dc-mcp/commit/e278f47ea0f76245612dc0144bd9538e79f749f3))
+
+# [0.24.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.23.0...v0.24.0) (2026-06-18)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/bitbucket
+
+# [0.23.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.22.0...v0.23.0) (2026-06-18)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/bitbucket
+
+# [0.22.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.21.0...v0.22.0) (2026-06-18)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/bitbucket
+
+# [0.21.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.20.1...v0.21.0) (2026-06-18)
+
+### Features
+
+- **bitbucket:** add multiline comment support for pull request comments ([edaf6ea](https://github.com/b1ff/atlassian-dc-mcp/commit/edaf6ea9a200afa811a8546f492d05fb37c4fe52))
+
+## [0.20.1](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.20.0...v0.20.1) (2026-06-18)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/bitbucket
+
+# [0.20.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.19.1...v0.20.0) (2026-06-08)
+
+### Features
+
+- **bitbucket:** support creating and updating pull requests as drafts ([190c19a](https://github.com/b1ff/atlassian-dc-mcp/commit/190c19a075285d18d8391bdb7fdd32feec605d32))
+
+## [0.19.1](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.19.0...v0.19.1) (2026-05-24)
+
+### Bug Fixes
+
+- **bitbucket:** clarify that reviewers param requires 'name', not 'slug' ([59c45dc](https://github.com/b1ff/atlassian-dc-mcp/commit/59c45dc917d9abf05939335b4ea62671a462bcda))
+
+# [0.19.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.18.0...v0.19.0) (2026-04-27)
+
+### Features
+
+- **setup:** add CLI flags and non-interactive mode ([7de53f0](https://github.com/b1ff/atlassian-dc-mcp/commit/7de53f0b23704e84324b59bbcb8d830a1596f44a))
+
+# [0.18.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.17.1...v0.18.0) (2026-04-24)
+
+### Features
+
+- **setup:** validate credentials via product services with retry and friendly errors ([6056320](https://github.com/b1ff/atlassian-dc-mcp/commit/60563200e62b513fe8f3b5b4a190edfa1be25a13))
+
+## [0.17.1](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.17.0...v0.17.1) (2026-04-23)
+
+### Bug Fixes
+
+- prevent double-concatenation of API base path after setup CLI ([39cd1c7](https://github.com/b1ff/atlassian-dc-mcp/commit/39cd1c7c6dc6dc842b110c6650002487df534dd5))
+
+# [0.17.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.16.0...v0.17.0) (2026-04-23)
+
+### Features
+
+- add interactive setup CLI with secure credential storage ([f317903](https://github.com/b1ff/atlassian-dc-mcp/commit/f317903a9975b66442f54e520a5a1656a69d1a1b))
+
+# [0.16.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.15.0...v0.16.0) (2026-04-14)
+
+### Features
+
+- add keywords to package.json for npm search visibility ([0735f27](https://github.com/b1ff/atlassian-dc-mcp/commit/0735f27600d8215ba0c11c48916d3edc844f01b5))
+- improve supply-chain transparency (closes [#26](https://github.com/b1ff/atlassian-dc-mcp/issues/26)) ([98912b2](https://github.com/b1ff/atlassian-dc-mcp/commit/98912b26bddc4cafd847eb526fa8f76546576203))
+
+# [0.15.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.14.3...v0.15.0) (2026-04-07)
+
+### Features
+
+- **bitbucket:** improve updatePullRequest tool descriptions to prevent missing version parameter ([7999012](https://github.com/b1ff/atlassian-dc-mcp/commit/7999012a7abad2fa55dc5a2300abef516bd92631))
+
+## [0.14.3](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.14.2...v0.14.3) (2026-04-02)
+
+### Bug Fixes
+
+- **bitbucket:** normalize project key and repo slug casing in API calls ([35cf924](https://github.com/b1ff/atlassian-dc-mcp/commit/35cf924d78974f73d59f2d6879873eb8bbe027e8))
+
+## [0.14.2](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.14.1...v0.14.2) (2026-04-02)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/bitbucket
+
+## [0.14.1](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.14.0...v0.14.1) (2026-04-01)
+
+### Bug Fixes
+
+- use proper version for MCP server responces ([d1f5e5b](https://github.com/b1ff/atlassian-dc-mcp/commit/d1f5e5b59c592921f940916af008363414aa4c0e))
+
+# [0.14.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.13.0...v0.14.0) (2026-03-23)
+
+### Features
+
+- **bitbucket:** add automatic filtering out resolved comment threads in PR activities ([f44244e](https://github.com/b1ff/atlassian-dc-mcp/commit/f44244ee739c7aa56dc11836f63af121d0e3e2c6))
+
+# [0.13.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.12.2...v0.13.0) (2026-03-21)
+
+### Features
+
+- add ability to specify external config file to MCP, to provide configuration to MCP without specifying credentials in the file ([c97d380](https://github.com/b1ff/atlassian-dc-mcp/commit/c97d38004ebc7e233ea276a36c2e233536d2d0ca))
+- **bitbucket:** add token-optimized response modes ([9c8f3c8](https://github.com/b1ff/atlassian-dc-mcp/commit/9c8f3c8c99be2fffb7a32ecf14def5e004a11512))
+
+## [0.12.2](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.12.1...v0.12.2) (2026-03-21)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/bitbucket
+
+## [0.12.1](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.12.0...v0.12.1) (2026-03-21)
+
+### Bug Fixes
+
+- **bitbucket:** [#22](https://github.com/b1ff/atlassian-dc-mcp/issues/22) address the issue that replies in PRs are invisible to LLM ([bb22fa1](https://github.com/b1ff/atlassian-dc-mcp/commit/bb22fa1e8cc80f3983c08f58bd6cdd735f7eb9d7))
+
+# [0.12.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.11.2...v0.12.0) (2026-03-18)
+
+### Features
+
+- add support for dashboard api ([a7b1eef](https://github.com/b1ff/atlassian-dc-mcp/commit/a7b1eef732b8d7ee8e9f32aee0c6d6502bf18c95))
+
+## [0.11.2](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.11.1...v0.11.2) (2026-03-12)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/bitbucket
+
+## [0.11.1](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.11.0...v0.11.1) (2026-03-12)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/bitbucket
+
+# [0.11.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.10.2...v0.11.0) (2026-03-09)
+
+### Features
+
+- **bitbucket:** add pending comment support and submitPullRequestReview tool ([0bd74c2](https://github.com/b1ff/atlassian-dc-mcp/commit/0bd74c2243524a5e8a9f7f7c464a01e18e9db884))
+
+## [0.10.2](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.10.1...v0.10.2) (2026-03-09)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/bitbucket
+
+## [0.10.1](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.10.0...v0.10.1) (2026-03-09)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/bitbucket
+
+# [0.10.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.9.12...v0.10.0) (2026-01-31)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/bitbucket
+
+## [0.9.12](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.9.11...v0.9.12) (2026-01-03)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/bitbucket
+
+## [0.9.11](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.9.10...v0.9.11) (2026-01-03)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/bitbucket
+
+## [0.9.10](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.9.9...v0.9.10) (2026-01-03)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/bitbucket
+
+## [0.9.9](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.9.8...v0.9.9) (2025-09-13)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/bitbucket
+
+## [0.9.8](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.9.7...v0.9.8) (2025-09-13)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/bitbucket
+
+## [0.9.7](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.9.6...v0.9.7) (2025-09-13)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/bitbucket
+
+## [0.9.6](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.9.3...v0.9.6) (2025-09-13)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/bitbucket
+
+## [0.9.5](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.9.3...v0.9.5) (2025-09-13)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/bitbucket
+
+## [0.9.4](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.9.3...v0.9.4) (2025-09-13)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/bitbucket
+
+## [0.9.3](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.9.2...v0.9.3) (2025-09-13)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/bitbucket
+
+## [0.9.2](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.9.0...v0.9.2) (2025-09-13)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/bitbucket
+
+## [0.9.1](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.9.0...v0.9.1) (2025-09-13)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/bitbucket
+
+# [0.9.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.8.2...v0.9.0) (2025-09-13)
+
+### Features
+
+- preparation to publish to MCP registry ([1fdb772](https://github.com/b1ff/atlassian-dc-mcp/commit/1fdb772b419a5c472fafa2de4304e471471447c5))
+
+## [0.8.3](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.8.0...v0.8.3) (2025-09-06)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/bitbucket
+
+## [0.8.2](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.8.0...v0.8.2) (2025-09-06)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/bitbucket
+
+## [0.8.1](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.8.0...v0.8.1) (2025-09-06)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/bitbucket
+
+# [0.8.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.7.0...v0.8.0) (2025-09-06)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/bitbucket
+
+# [0.7.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.6.0...v0.7.0) (2025-08-03)
+
+### Bug Fixes
+
+- update bitbucket tool name given that anthropic API does not accept long name generated by claude code. ([c670e7b](https://github.com/b1ff/atlassian-dc-mcp/commit/c670e7ba8e4c509cb486f72fedf012509e9234d2))
+
+### Features
+
+- **bitbucket:** add support for fetching pull request diffs based on the specified path ([29150f3](https://github.com/b1ff/atlassian-dc-mcp/commit/29150f32f37966e47bda3d4e322fef4923bf7df3))
+- **bitbucket:** add support for PR changes and comments posting ([3b1f95b](https://github.com/b1ff/atlassian-dc-mcp/commit/3b1f95bcc3731cc787ffb76cfce710e980e1cb58))
+- **bitbucket:** reduce size of PR comments ([125d990](https://github.com/b1ff/atlassian-dc-mcp/commit/125d9907eb1b7b81256e66b86b602ccc472e1200))
+
+## [0.6.1](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.6.0...v0.6.1) (2025-05-26)
+
+### Bug Fixes
+
+- update bitbucket tool name given that anthropic API does not accept long name generated by claude code. ([c670e7b](https://github.com/b1ff/atlassian-dc-mcp/commit/c670e7ba8e4c509cb486f72fedf012509e9234d2))
+
+# [0.6.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.5.0...v0.6.0) (2025-05-26)
+
+### Features
+
+- add the ability to read PR comments for bitbucket. ([3a895f5](https://github.com/b1ff/atlassian-dc-mcp/commit/3a895f5e353b62fb71985ea14d6b57a24740662b))
+
+# [0.5.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.3.4...v0.5.0) (2025-05-14)
+
+### Features
+
+- **bitbucket:** add support of api base path instead of only host to support paths based installations. ([dea959b](https://github.com/b1ff/atlassian-dc-mcp/commit/dea959bf64493a90a9a5058db6bf80c462de2ee7))
+
+# [0.4.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.3.4...v0.4.0) (2025-05-03)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/bitbucket
+
+## [0.3.4](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.3.3...v0.3.4) (2025-03-08)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/bitbucket
+
+# [0.3.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.2.1...v0.3.0) (2025-03-03)
+
+### Features
+
+- improve error details for confluence and bitbucket so the LLM is able to correct itself based on the error. ([96f469f](https://github.com/b1ff/atlassian-dc-mcp/commit/96f469f6562c38f7460a4e13096b7f55d45acc1c))
+
+# [0.2.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.1.6...v0.2.0) (2025-03-02)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/bitbucket
+
+## [0.1.5](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.1.4...v0.1.5) (2025-03-02)
+
+### Bug Fixes
+
+- **bitbucket:** remove dependencies from node-fetch polyfill since it is supported by node natively ([6268835](https://github.com/b1ff/atlassian-dc-mcp/commit/6268835a4ef80009b78f42dca073a04e0aca61e4))
+
+## [0.1.4](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.1.3...v0.1.4) (2025-03-02)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/bitbucket
+
+## [0.1.3](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.1.2...v0.1.3) (2025-03-02)
+
+### Bug Fixes
+
+- correct bin configurations and the relative paths. ([0bed1aa](https://github.com/b1ff/atlassian-dc-mcp/commit/0bed1aa86e94a1d0d589b43d1c50fad55025eb2c))
+
+## 0.1.2 (2025-03-02)
+
+### Bug Fixes
+
+- binary executable is now non compiled ones. ([18fa866](https://github.com/b1ff/atlassian-dc-mcp/commit/18fa8661d71e3b1246f35869bec0acefe7ac2df5))
+
+## 0.1.1 (2025-03-02)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/bitbucket

package/README.md

@@ -0,0 +1,236 @@
+# Atlassian Bitbucket Data Center MCP
+
+This package provides a Machine Comprehension Protocol (MCP) server for interacting with Atlassian Bitbucket Data Center edition.
+
+## Interactive Setup
+
+The easiest way to configure this server is the built-in `setup` subcommand:
+
+```bash
+npx bitbucket-datacenter-mcp setup
+```
+
+It prompts for host, API base path, default page size, and API token, then stores them in the most secure place available:
+
+- **macOS** — token in the login Keychain (service `atlassian-dc-mcp`, account `bitbucket-token`); host / base path / page size in `~/.atlassian-dc-mcp/bitbucket.env` (mode `0600`).
+- **Linux** — everything in `~/.atlassian-dc-mcp/bitbucket.env` with POSIX mode `0600` (read/write for your user only).
+- **Windows** — everything in `%USERPROFILE%\.atlassian-dc-mcp\bitbucket.env`. Node passes the mode bits but Windows ignores them, so the file inherits the ACL of your user profile directory (typically readable only by your user, SYSTEM, and Administrators).
+
+After setup, you can launch the server without any environment variables:
+
+```json
+{
+  "mcpServers": {
+    "atlassian-bitbucket-dc": {
+      "command": "npx",
+      "args": ["-y", "bitbucket-datacenter-mcp"]
+    }
+  }
+}
+```
+
+Environment variables still override stored values — see [Configuration sources](#configuration-sources) below.
+
+### Scripted / non-interactive setup
+
+For CI, remote sessions, or shell scripts, pass values as flags and add `--non-interactive` to skip prompts:
+
+```bash
+npx bitbucket-datacenter-mcp setup --non-interactive \
+  --host bitbucket.example.com \
+  --token "$BITBUCKET_TOKEN"
+```
+
+Available flags: `--host`/`-H`, `--api-base-path`/`-b`, `--token`/`-t`, `--default-page-size`/`-s`, `--non-interactive`/`-n`, `--help`/`-h`. In `--non-interactive` mode, missing values fall back to existing configuration and the run exits non-zero only if a host (or full-URL `--api-base-path`) cannot be resolved. The token is optional — omit it for anonymous access; an existing token is reused when `--token` is omitted. Run `npx bitbucket-datacenter-mcp setup --help` for full usage.
+
+## Claude Desktop Configuration
+
+To use this MCP connector with Claude Desktop, add the following to your Claude Desktop configuration:
+
+macOS:
+```
+~/Library/Application Support/Claude/claude_desktop_config.json
+```
+
+Windows:
+```
+%APPDATA%\Claude\claude_desktop_config.json
+```
+
+```json
+{
+  "mcpServers": {
+    "atlassian-bitbucket-dc": {
+      "command": "npx",
+      "args": ["-y", "bitbucket-datacenter-mcp"],
+      "env": {
+        "BITBUCKET_HOST": "your-bitbucket-host",
+        "BITBUCKET_API_TOKEN": "your-token"
+      }
+    }
+  }
+}
+```
+
+To reuse one shared dotenv file across multiple tools or MCP hosts, point the server at an absolute file path:
+
+```json
+{
+  "mcpServers": {
+    "atlassian-bitbucket-dc": {
+      "command": "npx",
+      "args": ["-y", "bitbucket-datacenter-mcp"],
+      "env": {
+        "ATLASSIAN_DC_MCP_CONFIG_FILE": "/Users/your-user/.config/atlassian-dc-mcp.env"
+      }
+    }
+  }
+}
+```
+
+Windows example:
+
+```json
+{
+  "mcpServers": {
+    "atlassian-bitbucket-dc": {
+      "command": "npx",
+      "args": ["-y", "bitbucket-datacenter-mcp"],
+      "env": {
+        "ATLASSIAN_DC_MCP_CONFIG_FILE": "C:\\\\Users\\\\your-user\\\\AppData\\\\Roaming\\\\atlassian-dc-mcp.env"
+      }
+    }
+  }
+}
+```
+
+Note: Set `BITBUCKET_HOST` variable only to domain + port without protocol (e.g., `your-instance.atlassian.net`). The https protocol is assumed.
+
+Alternatively, you can use `BITBUCKET_API_BASE_PATH` instead of `BITBUCKET_HOST` to specify the complete API base URL including protocol (e.g., `https://your-instance.atlassian.net/rest`). Note that the `/api/latest/` part is static and added automatically in the code, so you don't need to include it in the `BITBUCKET_API_BASE_PATH` value.
+
+## Features
+
+- Access repository information
+- Get file contents
+- Browse branches and commits
+- Get pull request information
+- Search and filter repositories
+
+## Setup
+
+1. Install dependencies:
+   ```
+   pnpm install
+   ```
+
+2. Create a `.env` file in the packages/bitbucket directory, or put the same values in a shared dotenv file and set `ATLASSIAN_DC_MCP_CONFIG_FILE` to its absolute path:
+   ```
+   BITBUCKET_HOST=your-bitbucket-instance.atlassian.net
+   # OR alternatively use
+   # BITBUCKET_API_BASE_PATH=https://your-bitbucket-instance.atlassian.net/rest
+   # Note: /api/latest/ is added automatically, do not include it
+   # Optional: omit for anonymous access if your instance allows unauthenticated reads
+   BITBUCKET_API_TOKEN=your-personal-access-token
+
+   # Optional: default page size for paginated read tools (fallback: 25)
+   BITBUCKET_DEFAULT_PAGE_SIZE=25
+   ```
+
+   See [Configuration sources](#configuration-sources) for the full precedence chain.
+
+   To create a personal access token:
+  - In Bitbucket, select your profile picture at the bottom left
+  - Select **Manage Account** > **HTTP access tokens**
+  - Select **Create token** and give it a name
+  - Set appropriate permissions for the token
+  - Copy the token and store it securely (you won't be able to see it again)
+
+## Configuration sources
+
+Each key is resolved by walking these sources in priority order and taking the first non-empty value:
+
+| Priority | Source | Reads | Written by `setup` |
+|---------:|--------|-------|--------------------|
+| 100 | `process.env` (`BITBUCKET_HOST`, `BITBUCKET_API_BASE_PATH`, `BITBUCKET_API_TOKEN`, `BITBUCKET_DEFAULT_PAGE_SIZE`) | all keys | — |
+| 80  | env file — `ATLASSIAN_DC_MCP_CONFIG_FILE` (absolute path) or `./.env` | all keys | — |
+| 60  | home file — `~/.atlassian-dc-mcp/bitbucket.env` on macOS/Linux, `%USERPROFILE%\.atlassian-dc-mcp\bitbucket.env` on Windows (mode `0600` on POSIX; Windows inherits the user-profile ACL) | all keys | host, apiBasePath, defaultPageSize (always); token (non-darwin or keychain fallback) |
+| 40  | macOS Keychain — service `atlassian-dc-mcp`, account `bitbucket-token` | token only | token (darwin only) |
+
+`setup` always writes non-secret fields to the home file and tries the keychain first for the token. If a higher-priority source shadows the value being saved, `setup` prints a warning so you can unset the env var.
+
+## Usage
+
+Or for development with auto-reload:
+
+```
+pnpm dev
+```
+
+### Available Tools
+
+#### 1. bitbucket_getRepositories
+
+Get a list of repositories from the Bitbucket Data Center instance.
+
+Parameters:
+- `projectKey` (string, optional): Filter repositories by project key
+- `limit` (number, optional): Maximum number of results to return
+- `start` (number, optional): Starting index for pagination
+
+#### 2. bitbucket_getRepository
+
+Get details of a specific repository from the Bitbucket Data Center instance.
+
+Parameters:
+- `projectKey` (string, required): The project key (e.g., "PROJECT")
+- `repositorySlug` (string, required): The repository slug (e.g., "repo-name")
+
+#### 3. bitbucket_getBranches
+
+Get branches for a repository from the Bitbucket Data Center instance.
+
+Parameters:
+- `projectKey` (string, required): The project key
+- `repositorySlug` (string, required): The repository slug
+- `filterText` (string, optional): Filter branches by name
+- `limit` (number, optional): Maximum number of results to return
+- `start` (number, optional): Starting index for pagination
+
+#### 4. bitbucket_getFileContent
+
+Get the content of a file from a repository in the Bitbucket Data Center instance.
+
+Parameters:
+- `projectKey` (string, required): The project key
+- `repositorySlug` (string, required): The repository slug
+- `path` (string, required): Path to the file in the repository
+- `at` (string, optional): Commit or branch to get the file from (defaults to main/master branch)
+
+#### 5. bitbucket_getPullRequests
+
+Get pull requests for a repository from the Bitbucket Data Center instance.
+
+Parameters:
+- `projectKey` (string, required): The project key
+- `repositorySlug` (string, required): The repository slug
+- `state` (string, optional): Filter by PR state (OPEN, MERGED, DECLINED)
+- `limit` (number, optional): Maximum number of results to return
+- `start` (number, optional): Starting index for pagination
+
+#### 6. bitbucket_getDashboardPullRequests
+
+Get pull requests from the Bitbucket dashboard across all repositories. Useful for finding all PRs where you are the author, reviewer, or participant without specifying a project or repository.
+
+Parameters:
+- `role` (string, optional): Filter by user's role — AUTHOR (default), REVIEWER, or PARTICIPANT
+- `state` (string, optional): Filter by PR state — OPEN (default), DECLINED, or MERGED
+- `closedSince` (number, optional): Timestamp in milliseconds. If state is not OPEN, return only PRs closed after this date
+- `order` (string, optional): Order of results — NEWEST (default), OLDEST, or PARTICIPANT
+- `limit` (number, optional): Maximum number of results to return. Defaults to `BITBUCKET_DEFAULT_PAGE_SIZE` or `25`.
+- `start` (number, optional): Starting index for pagination
+
+## Response Shaping
+
+- Paginated read tools use `BITBUCKET_DEFAULT_PAGE_SIZE` when `limit` is omitted.
+- `bitbucket_getPR_CommentsAndAction` and `bitbucket_getPullRequestChanges` support `output=summary|compact|full`. The default is `compact`.
+- `bitbucket_postPullRequestComment`, `bitbucket_createPullRequest`, and `bitbucket_updatePullRequest` support `output=ack|full`. The default is `ack`.

package/bin/run.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+const sub = process.argv[2];
+if (sub === 'setup') {
+  await import('../build/setup.js');
+} else {
+  await import('../build/index.js');
+}

package/build/__tests__/bitbucket-service.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=bitbucket-service.test.d.ts.map

package/build/__tests__/bitbucket-service.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitbucket-service.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/bitbucket-service.test.ts"],"names":[],"mappings":""}