{"_id":"@atercates/bitbucket-mcp","_rev":"9-6bf985ccb0520aadde1bc323c7c0888f","name":"@atercates/bitbucket-mcp","dist-tags":{"latest":"1.0.8"},"versions":{"1.0.0":{"name":"@atercates/bitbucket-mcp","version":"1.0.0","keywords":["bitbucket","bitbucket-cloud","bitbucket-server","mcp","model-context-protocol","ai","llm"],"author":{"name":"Bitbucket MCP Team"},"license":"MIT","_id":"@atercates/bitbucket-mcp@1.0.0","maintainers":[{"name":"atercates","email":"atercates@gmail.com"}],"homepage":"https://github.com/atercates/bitbucket-mcp#readme","bugs":{"url":"https://github.com/atercates/bitbucket-mcp/issues"},"bin":{"bitbucket-mcp":"dist/index.js"},"dist":{"shasum":"e6072990982602204c96df0b4e71594395cdf024","tarball":"https://registry.npmjs.org/@atercates/bitbucket-mcp/-/bitbucket-mcp-1.0.0.tgz","fileCount":77,"integrity":"sha512-ImHTaPUib7Qj3Nar2aMTOYcCff2Qwx63C25g3qzejupqHikQJn3YU9VhUzYy5hq4TbhuwmrahiGjbacqI8rVqw==","signatures":[{"sig":"MEUCIHRUh5QlOYJY5VMfUPHmdsCW21aeh2prTF3FSpubT3pIAiEAuVCXJQUqiz76WBt5qsFFg0o7BxzW+D2YNlBFeQqQTTU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":359933},"main":"dist/index.js","type":"module","_from":"file:atercates-bitbucket-mcp-1.0.0.tgz","types":"./dist/index.d.ts","engines":{"node":">=18"},"mcpName":"io.github.bitbucket-mcp/bitbucket-mcp","private":false,"scripts":{"dev":"tsx watch src/index.ts","lint":"eslint src","test":"vitest run","build":"tsc && chmod +x dist/index.js","start":"node dist/index.js","format":"prettier --write \"src/**/*.ts\"","release":"pnpm publish:patch","version":"git add -A src","lint:fix":"eslint src --fix","inspector":"pnpm dlx @modelcontextprotocol/inspector dist/index.js","test:watch":"vitest","postversion":"git push && git push --tags","format:check":"prettier --check \"src/**/*.ts\"","publish:major":"pnpm version major && pnpm publish","publish:minor":"pnpm version minor && pnpm publish","publish:patch":"pnpm version patch && pnpm publish","registry:manifest":"node scripts/generate-registry-manifest.cjs","registry:validate":"node scripts/validate-server-json.mjs"},"_npmUser":{"name":"atercates","email":"atercates@gmail.com"},"_resolved":"/tmp/da58c6f98425d97649a9c41f229eeaa6/atercates-bitbucket-mcp-1.0.0.tgz","_integrity":"sha512-ImHTaPUib7Qj3Nar2aMTOYcCff2Qwx63C25g3qzejupqHikQJn3YU9VhUzYy5hq4TbhuwmrahiGjbacqI8rVqw==","repository":{"url":"git+https://github.com/atercates/bitbucket-mcp.git","type":"git"},"_npmVersion":"11.8.0","description":"Model Context Protocol (MCP) server for Bitbucket Cloud and Server API integration","directories":{},"_nodeVersion":"24.13.1","dependencies":{"zod":"^4.3.6","axios":"^1.13.6","winston":"^3.19.0","@modelcontextprotocol/sdk":"1.27.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"ajv":"^8.18.0","tsx":"^4.21.0","eslint":"^9.39.4","vitest":"^4.1.1","prettier":"^3.8.1","@eslint/js":"^10.0.1","typescript":"^5.8.3","@types/node":"^25.5.0","ajv-formats":"^3.0.1","@types/express":"^5.0.6","typescript-eslint":"^8.57.2","eslint-config-prettier":"^10.1.8","eslint-plugin-prettier":"^5.5.5"},"_npmOperationalInternal":{"tmp":"tmp/bitbucket-mcp_1.0.0_1774444376075_0.962213837374964","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@atercates/bitbucket-mcp","version":"1.0.1","keywords":["bitbucket","bitbucket-cloud","bitbucket-server","mcp","model-context-protocol","ai","llm"],"author":{"name":"Bitbucket MCP Team"},"license":"MIT","_id":"@atercates/bitbucket-mcp@1.0.1","maintainers":[{"name":"atercates","email":"atercates@gmail.com"}],"homepage":"https://github.com/ATERCATES/bitbucket-mcp#readme","bugs":{"url":"https://github.com/ATERCATES/bitbucket-mcp/issues"},"bin":{"bitbucket-mcp":"dist/index.js"},"dist":{"shasum":"d0a7104f3a035217002bc88ee4e68b0a9442e8b6","tarball":"https://registry.npmjs.org/@atercates/bitbucket-mcp/-/bitbucket-mcp-1.0.1.tgz","fileCount":73,"integrity":"sha512-M0XN3kCarWVW8fFsMVjkPWqm5vshFGQWUkVrykfIU7XwPZx1xdamXNrM+BKcz3OozqJ5jlYcKFUNgBqeQKVunw==","signatures":[{"sig":"MEYCIQD3AaSrnGSWQudkAe/W8DtzCTFc4+FhwUIBWx+jaLGRKwIhAK75cOUXZwHpIeQi3IJB+QohIBYDlbHznmvpsaHGJqr2","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@atercates%2fbitbucket-mcp@1.0.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":333601},"main":"dist/index.js","type":"module","_from":"file:atercates-bitbucket-mcp-1.0.1.tgz","types":"./dist/index.d.ts","engines":{"node":">=18"},"mcpName":"io.github.bitbucket-mcp/bitbucket-mcp","private":false,"scripts":{"dev":"tsx watch src/index.ts","lint":"eslint src","test":"vitest run","build":"tsc && chmod +x dist/index.js","start":"node dist/index.js","format":"prettier --write \"src/**/*.ts\"","release":"pnpm publish:patch","version":"git add -A src","lint:fix":"eslint src --fix","inspector":"pnpm dlx @modelcontextprotocol/inspector dist/index.js","test:watch":"vitest","postversion":"git push && git push --tags","format:check":"prettier --check \"src/**/*.ts\"","publish:major":"pnpm version major && pnpm publish","publish:minor":"pnpm version minor && pnpm publish","publish:patch":"pnpm version patch && pnpm publish","registry:manifest":"node scripts/generate-registry-manifest.cjs","registry:validate":"node scripts/validate-server-json.mjs"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:02fcbd3b-1fd3-4249-bf0d-12b42c303eb4"}},"_resolved":"/tmp/8ddb4516df699f40d6ef48bed156db9e/atercates-bitbucket-mcp-1.0.1.tgz","_integrity":"sha512-M0XN3kCarWVW8fFsMVjkPWqm5vshFGQWUkVrykfIU7XwPZx1xdamXNrM+BKcz3OozqJ5jlYcKFUNgBqeQKVunw==","repository":{"url":"git+https://github.com/ATERCATES/bitbucket-mcp.git","type":"git"},"_npmVersion":"11.12.0","description":"Model Context Protocol (MCP) server for Bitbucket Cloud and Server API integration","directories":{},"_nodeVersion":"20.20.1","dependencies":{"zod":"^4.3.6","axios":"^1.13.6","winston":"^3.19.0","@modelcontextprotocol/sdk":"1.27.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"ajv":"^8.18.0","tsx":"^4.21.0","eslint":"^9.39.4","vitest":"^4.1.1","prettier":"^3.8.1","@eslint/js":"^10.0.1","typescript":"^5.8.3","@types/node":"^25.5.0","ajv-formats":"^3.0.1","@types/express":"^5.0.6","typescript-eslint":"^8.57.2","eslint-config-prettier":"^10.1.8","eslint-plugin-prettier":"^5.5.5"},"_npmOperationalInternal":{"tmp":"tmp/bitbucket-mcp_1.0.1_1774445709610_0.807896422448571","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@atercates/bitbucket-mcp","version":"1.0.2","keywords":["bitbucket","bitbucket-cloud","bitbucket-server","mcp","model-context-protocol","ai","llm"],"author":{"name":"ATERCATES"},"license":"MIT","_id":"@atercates/bitbucket-mcp@1.0.2","maintainers":[{"name":"atercates","email":"atercates@gmail.com"}],"homepage":"https://github.com/ATERCATES/bitbucket-mcp#readme","bugs":{"url":"https://github.com/ATERCATES/bitbucket-mcp/issues"},"bin":{"bitbucket-mcp":"dist/index.js"},"dist":{"shasum":"bfcd0949e6c7c42864a5a698c5c8e5abab798923","tarball":"https://registry.npmjs.org/@atercates/bitbucket-mcp/-/bitbucket-mcp-1.0.2.tgz","fileCount":71,"integrity":"sha512-fboMDys6LCR03yT5t7Lvh08ci7uA7VA5xz9jblIXTTJPg0tazvjY05DYUIoVTle5vNnuJbXrbyCyows2X1FfpA==","signatures":[{"sig":"MEUCIQD/2IX/HcopL9CTqiKviHjQZWJd1aC6c9sZfavTJaXeyAIgeKrvCZlfE0VJxNibJxR9+vVgDKh4FkXr01tUG3hYRts=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@atercates%2fbitbucket-mcp@1.0.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":318981},"main":"dist/index.js","type":"module","_from":"file:atercates-bitbucket-mcp-1.0.2.tgz","types":"./dist/index.d.ts","engines":{"node":">=24"},"mcpName":"io.github.bitbucket-mcp/bitbucket-mcp","private":false,"scripts":{"dev":"tsx watch src/index.ts","lint":"eslint src","test":"vitest run","build":"tsc && chmod +x dist/index.js","start":"node dist/index.js","format":"prettier --write \"src/**/*.ts\"","release":"pnpm publish:patch","version":"git add -A src","lint:fix":"eslint src --fix","inspector":"pnpm dlx @modelcontextprotocol/inspector dist/index.js","test:watch":"vitest","postversion":"git push && git push --tags","format:check":"prettier --check \"src/**/*.ts\"","publish:major":"pnpm version major && pnpm publish","publish:minor":"pnpm version minor && pnpm publish","publish:patch":"pnpm version patch && pnpm publish"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:02fcbd3b-1fd3-4249-bf0d-12b42c303eb4"}},"_resolved":"/tmp/d42633061a15553a702dc570d4a386df/atercates-bitbucket-mcp-1.0.2.tgz","_integrity":"sha512-fboMDys6LCR03yT5t7Lvh08ci7uA7VA5xz9jblIXTTJPg0tazvjY05DYUIoVTle5vNnuJbXrbyCyows2X1FfpA==","repository":{"url":"git+https://github.com/ATERCATES/bitbucket-mcp.git","type":"git"},"_npmVersion":"11.9.0","description":"Model Context Protocol (MCP) server for Bitbucket Cloud and Server API integration","directories":{},"_nodeVersion":"24.14.0","dependencies":{"zod":"^4.3.6","axios":"^1.13.6","winston":"^3.19.0","@modelcontextprotocol/sdk":"1.27.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","eslint":"^9.39.4","vitest":"^4.1.1","prettier":"^3.8.1","@eslint/js":"^10.0.1","typescript":"^5.8.3","@types/node":"^25.5.0","@types/express":"^5.0.6","typescript-eslint":"^8.57.2","eslint-config-prettier":"^10.1.8","eslint-plugin-prettier":"^5.5.5"},"_npmOperationalInternal":{"tmp":"tmp/bitbucket-mcp_1.0.2_1774452189596_0.4292583563965573","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@atercates/bitbucket-mcp","version":"1.0.3","keywords":["bitbucket","bitbucket-cloud","bitbucket-server","mcp","model-context-protocol","ai","llm"],"author":{"name":"ATERCATES"},"license":"MIT","_id":"@atercates/bitbucket-mcp@1.0.3","maintainers":[{"name":"atercates","email":"atercates@gmail.com"}],"homepage":"https://github.com/ATERCATES/bitbucket-mcp#readme","bugs":{"url":"https://github.com/ATERCATES/bitbucket-mcp/issues"},"bin":{"bitbucket-mcp":"dist/index.js"},"dist":{"shasum":"54ee253522e44c4e4fc234e6e58baaec3030939a","tarball":"https://registry.npmjs.org/@atercates/bitbucket-mcp/-/bitbucket-mcp-1.0.3.tgz","fileCount":71,"integrity":"sha512-9EX5WgdNTmxRqqf7oYZd2nRkswgnV6oGB3T2AaXA5kRE1DLz9Qjsj1v/2Kf1jjnCvIQyQx0WLiORqkLSehBfNA==","signatures":[{"sig":"MEUCIQDJ/7r/SGY+CQesy6sLEm4Rf0igJ8W5yw5tVP6eCXW5PwIgfwpSjgxfHLHkOpnJm5GcxAN0v+H4mds3Lbedv4+g35Y=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@atercates%2fbitbucket-mcp@1.0.3","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":323622},"main":"dist/index.js","type":"module","_from":"file:atercates-bitbucket-mcp-1.0.3.tgz","types":"./dist/index.d.ts","engines":{"node":">=24"},"mcpName":"io.github.bitbucket-mcp/bitbucket-mcp","private":false,"scripts":{"dev":"tsx watch src/index.ts","lint":"eslint src","test":"vitest run","build":"tsc && chmod +x dist/index.js","start":"node dist/index.js","format":"prettier --write \"src/**/*.ts\"","release":"pnpm publish:patch","version":"git add -A src","lint:fix":"eslint src --fix","inspector":"pnpm dlx @modelcontextprotocol/inspector dist/index.js","test:watch":"vitest","postversion":"git push && git push --tags","format:check":"prettier --check \"src/**/*.ts\"","publish:major":"pnpm version major && pnpm publish","publish:minor":"pnpm version minor && pnpm publish","publish:patch":"pnpm version patch && pnpm publish"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:02fcbd3b-1fd3-4249-bf0d-12b42c303eb4"}},"_resolved":"/tmp/30cb0c8636f6e9eea8eb07415463bbb8/atercates-bitbucket-mcp-1.0.3.tgz","_integrity":"sha512-9EX5WgdNTmxRqqf7oYZd2nRkswgnV6oGB3T2AaXA5kRE1DLz9Qjsj1v/2Kf1jjnCvIQyQx0WLiORqkLSehBfNA==","repository":{"url":"git+https://github.com/ATERCATES/bitbucket-mcp.git","type":"git"},"_npmVersion":"11.9.0","description":"Model Context Protocol (MCP) server for Bitbucket Cloud and Server API integration","directories":{},"_nodeVersion":"24.14.0","dependencies":{"zod":"^4.3.6","axios":"^1.13.6","winston":"^3.19.0","@modelcontextprotocol/sdk":"1.27.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","eslint":"^9.39.4","vitest":"^4.1.1","prettier":"^3.8.1","@eslint/js":"^10.0.1","typescript":"^5.8.3","@types/node":"^25.5.0","@types/express":"^5.0.6","typescript-eslint":"^8.57.2","eslint-config-prettier":"^10.1.8","eslint-plugin-prettier":"^5.5.5"},"_npmOperationalInternal":{"tmp":"tmp/bitbucket-mcp_1.0.3_1774529261654_0.576904941741053","host":"s3://npm-registry-packages-npm-production"}},"1.0.4":{"name":"@atercates/bitbucket-mcp","version":"1.0.4","keywords":["bitbucket","bitbucket-cloud","bitbucket-server","mcp","model-context-protocol","ai","llm"],"author":{"name":"ATERCATES"},"license":"MIT","_id":"@atercates/bitbucket-mcp@1.0.4","maintainers":[{"name":"atercates","email":"atercates@gmail.com"}],"homepage":"https://github.com/ATERCATES/bitbucket-mcp#readme","bugs":{"url":"https://github.com/ATERCATES/bitbucket-mcp/issues"},"bin":{"bitbucket-mcp":"dist/index.js"},"dist":{"shasum":"11647f5e1ba4bb70a2c26612f839b3ff60479c46","tarball":"https://registry.npmjs.org/@atercates/bitbucket-mcp/-/bitbucket-mcp-1.0.4.tgz","fileCount":74,"integrity":"sha512-QvQsEjCh/dj3sKuQuvPvuS0jVqNeKIhp7XrStV810OnKAtu33/WM/1Q5UjX/iPuOs75EyRtzvrK4/ELxwJ6h2Q==","signatures":[{"sig":"MEUCIQCxA4QeviZWy9QZm/VhtQCb4uGBWFdni83tilo3kQcv5wIgb66RVRUwYWKXSmDrnmX4Cy33Xv5wRgEUWUunX4l1QYM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@atercates%2fbitbucket-mcp@1.0.4","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":328169},"main":"dist/index.js","type":"module","_from":"file:atercates-bitbucket-mcp-1.0.4.tgz","types":"./dist/index.d.ts","engines":{"node":">=24"},"mcpName":"io.github.bitbucket-mcp/bitbucket-mcp","private":false,"scripts":{"dev":"tsx watch src/index.ts","lint":"eslint src","test":"vitest run","build":"tsc && chmod +x dist/index.js","start":"node dist/index.js","format":"prettier --write \"src/**/*.ts\"","release":"pnpm publish:patch","version":"git add -A src","lint:fix":"eslint src --fix","inspector":"pnpm dlx @modelcontextprotocol/inspector node -r dotenv/config dist/index.js","test:watch":"vitest","postversion":"git push && git push --tags","format:check":"prettier --check \"src/**/*.ts\"","publish:major":"pnpm version major && pnpm publish","publish:minor":"pnpm version minor && pnpm publish","publish:patch":"pnpm version patch && pnpm publish"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:02fcbd3b-1fd3-4249-bf0d-12b42c303eb4"}},"_resolved":"/tmp/86d1b266da81671e5dd140b2dd445bbc/atercates-bitbucket-mcp-1.0.4.tgz","_integrity":"sha512-QvQsEjCh/dj3sKuQuvPvuS0jVqNeKIhp7XrStV810OnKAtu33/WM/1Q5UjX/iPuOs75EyRtzvrK4/ELxwJ6h2Q==","repository":{"url":"git+https://github.com/ATERCATES/bitbucket-mcp.git","type":"git"},"_npmVersion":"11.9.0","description":"Model Context Protocol (MCP) server for Bitbucket Cloud and Server API integration","directories":{},"_nodeVersion":"24.14.0","dependencies":{"zod":"^4.3.6","axios":"^1.13.6","winston":"^3.19.0","@modelcontextprotocol/sdk":"1.27.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","dotenv":"^17.3.1","eslint":"^9.39.4","vitest":"^4.1.1","prettier":"^3.8.1","@eslint/js":"^10.0.1","typescript":"^5.8.3","@types/node":"^25.5.0","@types/express":"^5.0.6","typescript-eslint":"^8.57.2","eslint-config-prettier":"^10.1.8","eslint-plugin-prettier":"^5.5.5"},"_npmOperationalInternal":{"tmp":"tmp/bitbucket-mcp_1.0.4_1774538029777_0.8203037215262843","host":"s3://npm-registry-packages-npm-production"}},"1.0.5":{"name":"@atercates/bitbucket-mcp","version":"1.0.5","keywords":["bitbucket","bitbucket-cloud","bitbucket-server","mcp","model-context-protocol","ai","llm"],"author":{"name":"ATERCATES"},"license":"MIT","_id":"@atercates/bitbucket-mcp@1.0.5","maintainers":[{"name":"atercates","email":"atercates@gmail.com"}],"homepage":"https://github.com/ATERCATES/bitbucket-mcp#readme","bugs":{"url":"https://github.com/ATERCATES/bitbucket-mcp/issues"},"bin":{"bitbucket-mcp":"dist/index.js"},"dist":{"shasum":"901a1ee3c2ae556ea8507adcad2bdcafe2a6d8dc","tarball":"https://registry.npmjs.org/@atercates/bitbucket-mcp/-/bitbucket-mcp-1.0.5.tgz","fileCount":74,"integrity":"sha512-+4oOi/KVp9jLhgSVQ068AqvXWDnSKWV7A+4DsUpmq+guAfgJUPuCruKTDJ+6BgTtTQ5bxFyYqbJSP3LbWPbuuw==","signatures":[{"sig":"MEUCIH4R/JEJkU7MwgVuDEsV6pqZokA+2TJkBBS3nwse77RsAiEAwxF4E9W2DoaAesyrxFPQlsaXMGpiNVElmxsosEfHOQs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@atercates%2fbitbucket-mcp@1.0.5","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":329313},"main":"dist/index.js","type":"module","_from":"file:atercates-bitbucket-mcp-1.0.5.tgz","types":"./dist/index.d.ts","engines":{"node":">=24"},"mcpName":"io.github.bitbucket-mcp/bitbucket-mcp","private":false,"scripts":{"dev":"tsx watch src/index.ts","lint":"eslint src","test":"vitest run","build":"tsc && chmod +x dist/index.js","start":"node dist/index.js","format":"prettier --write \"src/**/*.ts\"","release":"pnpm publish:patch","version":"git add -A src","lint:fix":"eslint src --fix","inspector":"pnpm dlx @modelcontextprotocol/inspector node -r dotenv/config dist/index.js","test:watch":"vitest","postversion":"git push && git push --tags","format:check":"prettier --check \"src/**/*.ts\"","publish:major":"pnpm version major && pnpm publish","publish:minor":"pnpm version minor && pnpm publish","publish:patch":"pnpm version patch && pnpm publish"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:02fcbd3b-1fd3-4249-bf0d-12b42c303eb4"}},"_resolved":"/tmp/96da8cd81808d40396a4b1b1ead64b3e/atercates-bitbucket-mcp-1.0.5.tgz","_integrity":"sha512-+4oOi/KVp9jLhgSVQ068AqvXWDnSKWV7A+4DsUpmq+guAfgJUPuCruKTDJ+6BgTtTQ5bxFyYqbJSP3LbWPbuuw==","repository":{"url":"git+https://github.com/ATERCATES/bitbucket-mcp.git","type":"git"},"_npmVersion":"11.11.0","description":"Model Context Protocol (MCP) server for Bitbucket Cloud and Server API integration","directories":{},"_nodeVersion":"24.14.1","dependencies":{"zod":"^4.3.6","axios":"^1.13.6","winston":"^3.19.0","@modelcontextprotocol/sdk":"1.27.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","dotenv":"^17.3.1","eslint":"^9.39.4","vitest":"^4.1.1","prettier":"^3.8.1","@eslint/js":"^10.0.1","typescript":"^5.8.3","@types/node":"^25.5.0","@types/express":"^5.0.6","typescript-eslint":"^8.57.2","eslint-config-prettier":"^10.1.8","eslint-plugin-prettier":"^5.5.5"},"_npmOperationalInternal":{"tmp":"tmp/bitbucket-mcp_1.0.5_1775562669102_0.9530029763176089","host":"s3://npm-registry-packages-npm-production"}},"1.0.6":{"name":"@atercates/bitbucket-mcp","version":"1.0.6","keywords":["bitbucket","bitbucket-cloud","bitbucket-server","mcp","model-context-protocol","ai","llm"],"author":{"name":"ATERCATES"},"license":"MIT","_id":"@atercates/bitbucket-mcp@1.0.6","maintainers":[{"name":"atercates","email":"atercates@gmail.com"}],"homepage":"https://github.com/ATERCATES/bitbucket-mcp#readme","bugs":{"url":"https://github.com/ATERCATES/bitbucket-mcp/issues"},"bin":{"bitbucket-mcp":"dist/index.js"},"dist":{"shasum":"659a71f1be76aee4dddddb0a44ac68bd7da2906c","tarball":"https://registry.npmjs.org/@atercates/bitbucket-mcp/-/bitbucket-mcp-1.0.6.tgz","fileCount":74,"integrity":"sha512-xh+09z83X7fo4Qrh8kGZBS8BCx8GbQw0LK8znOCqjuA7TYOd9zvIbFHXJ1CJEawkAkpcq1UDWO847Ulq56MDRw==","signatures":[{"sig":"MEYCIQDYjZYP60yH1Y8Rx9QIMDJlOqfwVKWeWVV7g+r7mV+snQIhAP1viFe9Ac02N9cIoRiv9YgaJXrE2P/I3ZahV6tXndZL","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@atercates%2fbitbucket-mcp@1.0.6","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":335376},"main":"dist/index.js","type":"module","_from":"file:atercates-bitbucket-mcp-1.0.6.tgz","types":"./dist/index.d.ts","engines":{"node":">=24"},"mcpName":"io.github.bitbucket-mcp/bitbucket-mcp","private":false,"scripts":{"dev":"tsx watch src/index.ts","lint":"eslint src","test":"vitest run","build":"tsc && chmod +x dist/index.js","start":"node dist/index.js","format":"prettier --write \"src/**/*.ts\"","release":"pnpm publish:patch","version":"git add -A src","lint:fix":"eslint src --fix","inspector":"pnpm dlx @modelcontextprotocol/inspector node -r dotenv/config dist/index.js","test:watch":"vitest","postversion":"git push && git push --tags","format:check":"prettier --check \"src/**/*.ts\"","publish:major":"pnpm version major && pnpm publish","publish:minor":"pnpm version minor && pnpm publish","publish:patch":"pnpm version patch && pnpm publish"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:02fcbd3b-1fd3-4249-bf0d-12b42c303eb4"}},"_resolved":"/tmp/96ba26c5dfcdb9826aa9fdb4752e230c/atercates-bitbucket-mcp-1.0.6.tgz","_integrity":"sha512-xh+09z83X7fo4Qrh8kGZBS8BCx8GbQw0LK8znOCqjuA7TYOd9zvIbFHXJ1CJEawkAkpcq1UDWO847Ulq56MDRw==","repository":{"url":"git+https://github.com/ATERCATES/bitbucket-mcp.git","type":"git"},"_npmVersion":"11.11.0","description":"Model Context Protocol (MCP) server for Bitbucket Cloud and Server API integration","directories":{},"_nodeVersion":"24.14.1","dependencies":{"zod":"^4.3.6","axios":"^1.13.6","winston":"^3.19.0","@modelcontextprotocol/sdk":"1.27.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","dotenv":"^17.3.1","eslint":"^9.39.4","vitest":"^4.1.1","prettier":"^3.8.1","@eslint/js":"^10.0.1","typescript":"^5.8.3","@types/node":"^25.5.0","@types/express":"^5.0.6","typescript-eslint":"^8.57.2","eslint-config-prettier":"^10.1.8","eslint-plugin-prettier":"^5.5.5"},"_npmOperationalInternal":{"tmp":"tmp/bitbucket-mcp_1.0.6_1775563675675_0.26811381146792934","host":"s3://npm-registry-packages-npm-production"}},"1.0.7":{"name":"@atercates/bitbucket-mcp","version":"1.0.7","keywords":["bitbucket","bitbucket-cloud","bitbucket-server","mcp","model-context-protocol","ai","llm"],"author":{"name":"ATERCATES"},"license":"MIT","_id":"@atercates/bitbucket-mcp@1.0.7","maintainers":[{"name":"atercates","email":"atercates@gmail.com"}],"homepage":"https://github.com/ATERCATES/bitbucket-mcp#readme","bugs":{"url":"https://github.com/ATERCATES/bitbucket-mcp/issues"},"bin":{"bitbucket-mcp":"dist/index.js"},"dist":{"shasum":"1058cebc981a45b946230d90c6015be158ee74e9","tarball":"https://registry.npmjs.org/@atercates/bitbucket-mcp/-/bitbucket-mcp-1.0.7.tgz","fileCount":74,"integrity":"sha512-TM6MS13Csl1rxYEbAc3OpRieMSUwFuJE7w0UiawbBGst60gyI3iRuPw8mhQiUTj9m82Lx7BZFTlIMtSDKs2ybw==","signatures":[{"sig":"MEQCIHolLkHqmN9xGcbKygweW5GYeWsIjBn4kQC/YdpV7gziAiBV/2BnhQR/JnpBQDXoWmulixEAlpHEV5UIN08uaEOpQg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@atercates%2fbitbucket-mcp@1.0.7","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":325342},"main":"dist/index.js","type":"module","_from":"file:atercates-bitbucket-mcp-1.0.7.tgz","types":"./dist/index.d.ts","engines":{"node":">=24"},"mcpName":"io.github.bitbucket-mcp/bitbucket-mcp","private":false,"scripts":{"dev":"tsx watch src/index.ts","lint":"eslint src","test":"vitest run","build":"tsc && chmod +x dist/index.js","start":"node dist/index.js","format":"prettier --write \"src/**/*.ts\"","release":"pnpm publish:patch","version":"git add -A src","lint:fix":"eslint src --fix","inspector":"pnpm dlx @modelcontextprotocol/inspector node -r dotenv/config dist/index.js","test:watch":"vitest","postversion":"git push && git push --tags","format:check":"prettier --check \"src/**/*.ts\"","publish:major":"pnpm version major && pnpm publish","publish:minor":"pnpm version minor && pnpm publish","publish:patch":"pnpm version patch && pnpm publish"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:0802c619-4085-423a-bd98-dbe4da5d236e"}},"_resolved":"/tmp/c357624e269a83bd2666135dca024628/atercates-bitbucket-mcp-1.0.7.tgz","_integrity":"sha512-TM6MS13Csl1rxYEbAc3OpRieMSUwFuJE7w0UiawbBGst60gyI3iRuPw8mhQiUTj9m82Lx7BZFTlIMtSDKs2ybw==","repository":{"url":"git+https://github.com/ATERCATES/bitbucket-mcp.git","type":"git"},"_npmVersion":"11.11.0","description":"Model Context Protocol (MCP) server for Bitbucket Cloud and Server API integration","directories":{},"_nodeVersion":"24.14.1","dependencies":{"zod":"^4.3.6","axios":"^1.13.6","winston":"^3.19.0","@modelcontextprotocol/sdk":"1.27.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","dotenv":"^17.3.1","eslint":"^9.39.4","vitest":"^4.1.1","prettier":"^3.8.1","@eslint/js":"^10.0.1","typescript":"^5.8.3","@types/node":"^25.5.0","@types/express":"^5.0.6","typescript-eslint":"^8.57.2","eslint-config-prettier":"^10.1.8","eslint-plugin-prettier":"^5.5.5"},"_npmOperationalInternal":{"tmp":"tmp/bitbucket-mcp_1.0.7_1778153538895_0.8380191451834371","host":"s3://npm-registry-packages-npm-production"}},"1.0.8":{"name":"@atercates/bitbucket-mcp","version":"1.0.8","description":"Model Context Protocol (MCP) server for Bitbucket Cloud and Server API integration","mcpName":"io.github.bitbucket-mcp/bitbucket-mcp","type":"module","private":false,"main":"dist/index.js","bin":{"bitbucket-mcp":"dist/index.js"},"keywords":["bitbucket","bitbucket-cloud","bitbucket-server","mcp","model-context-protocol","ai","llm"],"author":{"name":"ATERCATES"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/ATERCATES/bitbucket-mcp.git"},"homepage":"https://github.com/ATERCATES/bitbucket-mcp#readme","bugs":{"url":"https://github.com/ATERCATES/bitbucket-mcp/issues"},"dependencies":{"@modelcontextprotocol/sdk":"1.27.1","axios":"^1.13.6","winston":"^3.19.0","zod":"^4.3.6"},"devDependencies":{"@eslint/js":"^10.0.1","@types/express":"^5.0.6","@types/node":"^25.5.0","dotenv":"^17.3.1","eslint":"^9.39.4","eslint-config-prettier":"^10.1.8","eslint-plugin-prettier":"^5.5.5","prettier":"^3.8.1","tsx":"^4.21.0","typescript":"^5.8.3","typescript-eslint":"^8.57.2","vitest":"^4.1.1"},"engines":{"node":">=24"},"publishConfig":{"access":"public"},"scripts":{"build":"tsc && chmod +x dist/index.js","start":"node dist/index.js","dev":"tsx watch src/index.ts","version":"git add -A src","postversion":"git push && git push --tags","publish:patch":"pnpm version patch && pnpm publish","publish:minor":"pnpm version minor && pnpm publish","publish:major":"pnpm version major && pnpm publish","release":"pnpm publish:patch","test":"vitest run","test:watch":"vitest","lint":"eslint src","lint:fix":"eslint src --fix","format":"prettier --write \"src/**/*.ts\"","format:check":"prettier --check \"src/**/*.ts\"","inspector":"pnpm dlx @modelcontextprotocol/inspector node -r dotenv/config dist/index.js"},"types":"./dist/index.d.ts","_id":"@atercates/bitbucket-mcp@1.0.8","_integrity":"sha512-ZLAp03zKs9aSOvJmtnik65kW1nLwM7sYpwoftGbHXgTeww2ZSCKPpV9HeAhh51HgPn+wKZO5rTRQkjFVgpb0Kg==","_resolved":"/tmp/fb774e07cbeba999f111363a8739844b/atercates-bitbucket-mcp-1.0.8.tgz","_from":"file:atercates-bitbucket-mcp-1.0.8.tgz","_nodeVersion":"24.18.0","_npmVersion":"11.16.0","dist":{"integrity":"sha512-ZLAp03zKs9aSOvJmtnik65kW1nLwM7sYpwoftGbHXgTeww2ZSCKPpV9HeAhh51HgPn+wKZO5rTRQkjFVgpb0Kg==","shasum":"dc09181f71e12fdea8969f278bdb3d8c19fb4afc","tarball":"https://registry.npmjs.org/@atercates/bitbucket-mcp/-/bitbucket-mcp-1.0.8.tgz","fileCount":74,"unpackedSize":327949,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@atercates%2fbitbucket-mcp@1.0.8","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIG+t8cxMgns4sVH3uCIOCo6j8PwQcHFQFDz/0mhmYFTYAiAMhPcKdZjM0C8I6F2bA5iVarB0WG/1H4z7A2+EA7VfMw=="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:0802c619-4085-423a-bd98-dbe4da5d236e"}},"directories":{},"maintainers":[{"name":"atercates","email":"atercates@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/bitbucket-mcp_1.0.8_1785412855542_0.9274789336013025"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-25T13:12:56.003Z","modified":"2026-07-30T12:00:57.714Z","1.0.0":"2026-03-25T13:12:56.225Z","1.0.1":"2026-03-25T13:35:09.751Z","1.0.2":"2026-03-25T15:23:09.750Z","1.0.3":"2026-03-26T12:47:41.811Z","1.0.4":"2026-03-26T15:13:49.988Z","1.0.5":"2026-04-07T11:51:09.232Z","1.0.6":"2026-04-07T12:07:55.836Z","1.0.7":"2026-05-07T11:32:19.048Z","1.0.8":"2026-07-30T12:00:55.681Z"},"bugs":{"url":"https://github.com/ATERCATES/bitbucket-mcp/issues"},"author":{"name":"ATERCATES"},"license":"MIT","homepage":"https://github.com/ATERCATES/bitbucket-mcp#readme","keywords":["bitbucket","bitbucket-cloud","bitbucket-server","mcp","model-context-protocol","ai","llm"],"repository":{"type":"git","url":"git+https://github.com/ATERCATES/bitbucket-mcp.git"},"description":"Model Context Protocol (MCP) server for Bitbucket Cloud and Server API integration","maintainers":[{"name":"atercates","email":"atercates@gmail.com"}],"readme":"# Bitbucket MCP Server\n\nA Model Context Protocol (MCP) server for integrating with Bitbucket Cloud and Server APIs. This MCP server enables AI assistants like Claude and Cursor to interact with your Bitbucket repositories, pull requests, pipelines, and other resources.\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![npm version](https://img.shields.io/npm/v/@atercates/bitbucket-mcp.svg)](https://www.npmjs.com/package/@atercates/bitbucket-mcp)\n\n## Features\n\n✨ **Comprehensive Bitbucket Integration** - 59 tools covering repositories, PRs, branches, commits, pipelines, and more\n\n🔒 **Secure Authentication** - App password tokens or basic auth with granular permission control via Bitbucket\n\n📝 **Well-Documented** - Complete API reference, architecture guides, and deployment instructions in `/docs`\n\n🧪 **Fully Tested** - Comprehensive unit test suite with full tool coverage (Vitest)\n\n⚡ **Modular Design** - Clean, maintainable architecture organized by feature domain (11 handler modules)\n\n🛡️ **Safety First** - 3 operation modes (readonly, safe, full) with fine-grained tool control\n\n🚀 **Production Ready** - Built with pnpm, ESLint, Prettier, and modern TypeScript\n\n## Quick Start\n\n### Installation\n\n```bash\n# Option 1: Global install\npnpm add -g @atercates/bitbucket-mcp\n\n# Option 2: Use with NPX (no installation required)\nnpx -y @atercates/bitbucket-mcp@latest\n\n# Option 3: Local development\ngit clone https://github.com/ATERCATES/bitbucket-mcp.git\ncd bitbucket-mcp\npnpm install\npnpm build\npnpm start\n```\n\n### Configuration\n\n**REQUIRED Environment Variables:**\n\n```bash\n# Authentication (Personal API Token ONLY)\nexport BITBUCKET_USERNAME=\"user@example.com\"    # Your Atlassian email address\nexport BITBUCKET_API_TOKEN=\"ATBBxxxxxxxxxxxxx\"  # Personal API Token (starts with ATBB or ATATT)\n\n# Default Workspace (optional but recommended)\nexport BITBUCKET_WORKSPACE=\"my-workspace\"       # Your default workspace name\n```\n\n**Optional Configuration:**\n\n```bash\n# Server Operation Mode\nexport BITBUCKET_MODE=\"safe\"  # readonly | safe (default) | full\n\n# Fine-grained tool control\nexport BITBUCKET_ENABLED_TOOLS=\"getPullRequest,listPullRequests,createPullRequest\"\nexport BITBUCKET_DISABLED_TOOLS=\"deleteBranch,deleteRepository\"\n\n# Custom API URL (for self-hosted Bitbucket Server)\nexport BITBUCKET_URL=\"https://bitbucket.company.com/rest/api/2.0\"\n```\n\n**🔐 Operation Modes:**\n\n- **`readonly`** - Only GET operations (no modifications)\n- **`safe`** - GET + POST/PUT operations, but no deletes (default)\n- **`full`** - All operations including dangerous deletes\n\n**⚠️ Authentication Notes:**\n- This MCP server strictly enforces **Personal API Tokens** (starting with `ATBB` or `ATATT`)\n- App Passwords and Access Tokens (BBAT-xxx) are **NOT supported**\n- `BITBUCKET_USERNAME` must be your Atlassian email address\n\n### Running the Server\n\n```bash\n# If installed globally\nbitbucket-mcp\n\n# If using NPX\nnpx -y @atercates/bitbucket-mcp@latest\n\n# If installed locally\npnpm start\n```\n\nThe server will start and listen for MCP protocol connections via stdio.\n\n## Integration with MCP Clients\n\n### Claude / Cursor Configuration\n\nAdd to your MCP configuration (`.mcp.json` or similar):\n\n```json\n{\n  \"mcpServers\": {\n    \"bitbucket\": {\n      \"command\": \"bitbucket-mcp\",\n      \"env\": {\n        \"BITBUCKET_USERNAME\": \"user@example.com\",\n        \"BITBUCKET_API_TOKEN\": \"ATBBxxxxxxxxxxxxx\",\n        \"BITBUCKET_WORKSPACE\": \"my-workspace\",\n        \"BITBUCKET_MODE\": \"safe\"\n      }\n    }\n  }\n}\n```\n\n**Examples:**\n\n```json\n// Read-only mode (safe for production analysis)\n{\n  \"BITBUCKET_MODE\": \"readonly\"\n}\n\n// Safe mode (default - no deletes)\n{\n  \"BITBUCKET_MODE\": \"safe\"\n}\n\n// Full mode (all operations including deletes)\n{\n  \"BITBUCKET_MODE\": \"full\"\n}\n\n// Fine-grained control (only specific tools)\n{\n  \"BITBUCKET_ENABLED_TOOLS\": \"getPullRequest,listPullRequests,getPullRequestDiff\"\n}\n\n// Blacklist specific tools\n{\n  \"BITBUCKET_DISABLED_TOOLS\": \"deleteBranch,deleteRepository,deleteTag\"\n}\n```\n\nOr with npx:\n\n```json\n{\n  \"mcpServers\": {\n    \"bitbucket\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@atercates/bitbucket-mcp@latest\"],\n      \"env\": {\n        \"BITBUCKET_USERNAME\": \"user@example.com\",\n        \"BITBUCKET_API_TOKEN\": \"ATBBxxxxxxxxxxxxx\",\n        \"BITBUCKET_WORKSPACE\": \"my-workspace\",\n        \"BITBUCKET_MODE\": \"safe\"\n      }\n    }\n  }\n}\n```\n\n## Available Tools\n\nThe server provides 59 tools organized into 11 categories:\n\n| Category | Tools |\n|----------|-------|\n| **Repositories** | List, get, create repositories |\n| **Pull Requests** | Create, approve, merge, decline PRs |\n| **PR Comments** | Create, delete PR comments |\n| **PR Tasks** | Create, update, delete PR tasks (TODOs) |\n| **PR Content** | Get diffs and commits |\n| **Branches & Tags** | List, create, delete branches and tags |\n| **Commits** | List commits and commit details |\n| **Pipelines** | List, run, stop pipeline runs |\n| **Source Code** | Read file content from repositories |\n| **Users** | Get current user and workspace info |\n| **Branching Model** | Get branching strategy configuration |\n\n**Complete reference:** See [docs/TOOLS.md](docs/TOOLS.md)\n\n## Environment Variables\n\n### Authentication (Required)\n\n- `BITBUCKET_USERNAME` - Your Atlassian email address (e.g., `user@example.com`)\n- `BITBUCKET_API_TOKEN` - Personal API Token starting with `ATBB-` or `ATATT-`\n\n**How to create:**\n1. Go to https://bitbucket.org/account/settings/app-passwords/\n2. Click \"Create API token\"\n3. Select permissions: Repositories (Read, Write), Pull requests (Read, Write), Pipelines (Read)\n4. Copy the generated token\n5. Set expiration date (max 1 year)\n\n### Configuration (Optional)\n\n- `BITBUCKET_WORKSPACE` - Default workspace name (can be provided per-tool call)\n- `BITBUCKET_URL` - API base URL (default: `https://api.bitbucket.org/2.0`)\n- `BITBUCKET_MODE` - Operation mode: `readonly`, `safe` (default), or `full`\n- `BITBUCKET_ENABLED_TOOLS` - Comma-separated list of tools to enable (whitelist mode)\n- `BITBUCKET_DISABLED_TOOLS` - Comma-separated list of tools to disable (blacklist mode)\n\n### Logging (Optional)\n\n- `BITBUCKET_LOG_DISABLE` - Disable file logging (default: `false`)\n- `BITBUCKET_LOG_FILE` - Custom log file path\n- `BITBUCKET_LOG_DIR` - Custom log directory\n- `BITBUCKET_LOG_PER_CWD` - Create per-directory logs (default: `false`)\n\n## Documentation\n\n- **[Tools Reference](docs/TOOLS.md)** - Complete API documentation for all 59 tools with examples\n- **[Architecture Guide](docs/architecture/ARCHITECTURE.md)** - Technical design, modular structure, and extension guide\n\n## Development\n\n### Prerequisites\n\n- Node.js 24\n- pnpm (or npm)\n\n### Setup\n\n```bash\ngit clone https://github.com/ATERCATES/bitbucket-mcp.git\ncd bitbucket-mcp\npnpm install\n```\n\n### Build\n\n```bash\npnpm build          # Compile TypeScript\npnpm lint           # Run ESLint  \npnpm format         # Format with Prettier\npnpm format:check   # Check formatting\n```\n\n### Testing\n\n```bash\npnpm test           # Run Vitest suite\npnpm test:watch     # Watch mode\n```\n\n### Running in Development\n\n```bash\npnpm dev            # Run with tsx (watch mode, no build required)\n# OR\npnpm build && pnpm start\n```\n\n### MCP Inspector (Debugging)\n\n```bash\npnpm inspector      # Launch interactive MCP inspector to test tools\n```\n\n## Project Structure\n\n```\nsrc/\n├─ index.ts              # Entry point\n├─ server.ts             # MCP server orchestration\n├─ client.ts             # Bitbucket API client\n├─ config.ts             # Configuration management\n├─ logger.ts             # File-based logging\n├─ types.ts              # TypeScript definitions\n├─ schemas.ts            # JSON schemas\n├─ utils.ts              # Utilities\n├─ pagination.ts         # Pagination helper\n└─ handlers/             # Feature modules\n   ├─ repositories.ts\n   ├─ pull-requests.ts\n   ├─ pr-comments.ts\n   ├─ pr-tasks.ts\n   ├─ pr-content.ts\n   ├─ refs.ts\n   ├─ commits.ts\n   ├─ pipelines.ts\n   ├─ source.ts\n   ├─ users.ts\n   ├─ branching-model.ts\n   └─ index.ts\n\ndocs/\n├─ TOOLS.md              # Tools reference\n└─ architecture/\n   └─ ARCHITECTURE.md    # Technical design\n\n__tests__/\n├─ test-utils.ts         # Test helpers\n└─ handlers/             # Handler tests\n```\n\n## Architecture\n\nThe server uses a modular handler-based architecture:\n\n```\nMCP Client → Server → Handler Modules → BitbucketClient → Bitbucket API\n```\n\nEach handler module:\n- Defines tools (names, schemas, descriptions)\n- Implements handlers (async functions)\n- Can mark tools as dangerous\n- Is automatically registered by the server\n\nSee [docs/architecture/ARCHITECTURE.md](docs/architecture/ARCHITECTURE.md) for details.\n\n## Dangerous Operations\n\nSome tools that perform destructive operations are marked as dangerous:\n\n- `deletePullRequestComment`\n- `deletePullRequestTask`\n- `deleteBranch`\n- `deleteTag`\n\nThese require `BITBUCKET_MODE=full` to use, preventing accidental data loss.\n\n## Troubleshooting\n\n### Authentication Issues\n\n**Test your credentials:**\n```bash\n# Test Personal API Token\ncurl -u \"user@example.com:ATBBxxxxxx\" \\\n  https://api.bitbucket.org/2.0/user\n\n# Should return your user info if credentials are valid\n```\n\n**Common errors:**\n\n1. **\"BITBUCKET_USERNAME is required\"**\n   - Set `BITBUCKET_USERNAME` to your Atlassian email address.\n\n2. **\"BITBUCKET_API_TOKEN is required\"**\n   - Set `BITBUCKET_API_TOKEN` to your Personal API Token (starts with ATBB).\n\n3. **\"Invalid token format\"**\n   - The token must start with `ATBB`. App passwords and Access Tokens are not supported.\n\n4. **\"401 Unauthorized\"**\n   - Check username/token are correct\n   - Verify token hasn't expired (max 1 year)\n   - Ensure you are using your **email address** as username\n\n### View Logs\n\n**macOS:**\n```bash\ntail -f ~/Library/Logs/bitbucket-mcp/bitbucket.log\n```\n\n**Linux:**\n```bash\ntail -f ~/.local/state/bitbucket-mcp/bitbucket.log\n```\n\n**Windows:**\n```bash\nGet-Content -Path \"$env:LOCALAPPDATA\\bitbucket-mcp\\bitbucket.log\" -Tail 50 -Wait\n```\n\n### Self-Hosted Bitbucket\n\nFor self-hosted Bitbucket Server, set the API URL:\n\n```bash\nBITBUCKET_URL=https://bitbucket.mycompany.com/rest/api/2.0 bitbucket-mcp\n```\n\n## License\n\nMIT License - See [LICENSE](LICENSE) file for details.\n\n## Support\n\n- 🔧 Check [docs/TOOLS.md](docs/TOOLS.md) for tool documentation with examples\n- 🏗️ Review [docs/architecture/ARCHITECTURE.md](docs/architecture/ARCHITECTURE.md) for technical details\n- 🐛 Enable logging with `BITBUCKET_LOG_DISABLE=false` for debugging\n- 🐞 Report issues at https://github.com/ATERCATES/bitbucket-mcp/issues\n\n---\n\n**Architecture:** Modular handler-based design with 11 feature modules  \n**Test Framework:** Vitest  \n**Package Manager:** pnpm\n","readmeFilename":"README.md"}