{"report":{"v":1,"package":"@aashari/mcp-server-atlassian-bitbucket","version":"3.1.0","ranAt":"2026-11-16T11:25:56.387Z","install":{"ok":true,"integrity":"sha512-jM22hESjrexhBsM3bIRo1WpnqVgrMs/zX4ASSqAykx2sqxZrGOFA/vvCVVnYvGH4IN3sLa3mp/4uXFI7j1i4Vg==","deps":99,"scripts":["@aashari/mcp-server-atlassian-bitbucket"],"bins":["mcp-atlassian-bitbucket"],"license":"ISC","engines":"node >=18.0.0","repository":"https://github.com/aashari/mcp-server-atlassian-bitbucket.git","bin":"mcp-atlassian-bitbucket"},"start":{"ok":true,"ms":236,"serverName":"@aashari/mcp-server-atlassian-bitbucket","serverVersion":"3.1.0","protocol":"2025-06-18","stderr":"[11:26:00] [INFO] [utils/response.util.ts] Logger initialized with session ID: 84abdf4c-28dd-4a2d-a8d8-c468baa2bd84\n[11:26:00] [INFO] [utils/response.util.ts] Logs will be saved to: /tmp/.mcp/data/mcp-server.84abdf4c-28dd-4a2d-a8d8-c468baa2bd84.log\n[11:26:00] [INFO] [index.ts@main] Starting server with STDIO transport\n[11:26:00] [INFO] [index.ts] Starting MCP server in stdio mode with @aashari/mcp-server-atlassian-bitbucket v3.1.0\n[11:26:00] [INFO] [index.ts@startServer] Starting MCP server initialization...\n[11:26:00] [INFO] [index.ts@startServer] Initializing Bitbucket MCP server v3.1.0\n[11:26:00] [INFO] [index.ts@startServer] Registering MCP tools...\n[11:26:00] [INFO] [index.ts@startServer] All tools registered successfully\n[11:26:00] [INFO] [index.ts@startServer] Using STDIO transport for MCP communication\n[11:26:00] [INFO] [index.ts@startServer] MCP server started successfully on STDIO transport\n[11:26:00] [INFO] [index.ts@main] Server is now running\n"},"tools":[{"name":"bb_get","description":"Read any Bitbucket data. Returns TOON format by default (30-60% fewer tokens than JSON).\n\n**IMPORTANT - Cost Optimization:**\n- ALWAYS use `jq` param to filter response fields. Unfiltered responses are very expensive!\n- Use `pagelen` query param to restrict result count (e.g., `pagelen: \"5\"`)\n- If unsure about available fields, first fetch ONE item with `pagelen: \"1\"` and NO jq filter to explore the schema, then use jq in subsequent calls\n\n**Schema Discovery Pattern:**\n1. First call: `path: \"/workspaces\", queryParams: {\"pagelen\": \"1\"}` (no jq) - explore available fields\n2. Then use: `jq: \"values[*].{slug: slug, name: name, uuid: uuid}\"` - extract only what you need\n\n**Output format:** TOON (default, token-efficient) or JSON (`outputFormat: \"json\"`)\n\n**Common paths:**\n- `/workspaces` - list workspaces\n- `/repositories/{workspace}` - list repos in workspace\n- `/repositories/{workspace}/{repo}` - get repo details\n- `/repositories/{workspace}/{repo}/pullrequests` - list PRs\n- `/repositories/{workspace}/{repo}/pullrequests/{id}` - get PR details\n- `/repositories/{workspace}/{repo}/pullrequests/{id}/comments` - list PR comments\n- `/repositories/{workspace}/{repo}/pullrequests/{id}/diff` - get PR diff\n- `/repositories/{workspace}/{repo}/refs/branches` - list branches\n- `/repositories/{workspace}/{repo}/commits` - list commits\n- `/repositories/{workspace}/{repo}/src/{commit}/{filepath}` - get file content\n- `/repositories/{workspace}/{repo}/diff/{source}..{destination}` - compare branches/commits\n\n**Query params:** `pagelen` (page size), `page` (page number), `q` (filter), `sort` (order), `fields` (sparse response)\n\n**Example filters (q param):** `state=\"OPEN\"`, `source.branch.name=\"feature\"`, `title~\"bug\"`\n\n**JQ examples:** `values[*].slug`, `values[0]`, `values[*].{name: name, uuid: uuid}`\n\nThe `/2.0` prefix is added automatically. API reference: https://developer.atlassian.com/cloud/bitbucket/rest/","params":["path","queryParams","jq","outputFormat"]},{"name":"bb_post","description":"Create Bitbucket resources. Returns TOON format by default (token-efficient).\n\n**IMPORTANT - Cost Optimization:**\n- Use `jq` param to extract only needed fields from response (e.g., `jq: \"{id: id, title: title}\"`)\n- Unfiltered responses include all metadata and are expensive!\n\n**Output format:** TOON (default) or JSON (`outputFormat: \"json\"`)\n\n**Common operations:**\n\n1. **Create PR:** `/repositories/{workspace}/{repo}/pullrequests`\n   body: `{\"title\": \"...\", \"source\": {\"branch\": {\"name\": \"feature\"}}, \"destination\": {\"branch\": {\"name\": \"main\"}}}`\n\n2. **Add PR comment:** `/repositories/{workspace}/{repo}/pullrequests/{id}/comments`\n   body: `{\"content\": {\"raw\": \"Comment text\"}}`\n\n3. **Approve PR:** `/repositories/{workspace}/{repo}/pullrequests/{id}/approve`\n   body: `{}`\n\n4. **Request changes:** `/repositories/{workspace}/{repo}/pullrequests/{id}/request-changes`\n   body: `{}`\n\n5. **Merge PR:** `/repositories/{workspace}/{repo}/pullrequests/{id}/merge`\n   body: `{\"merge_strategy\": \"squash\"}` (strategies: merge_commit, squash, fast_forward)\n\nThe `/2.0` prefix is added automatically. API reference: https://developer.atlassian.com/cloud/bitbucket/rest/","params":["path","queryParams","jq","outputFormat","body"]},{"name":"bb_put","description":"Replace Bitbucket resources (full update). Returns TOON format by default.\n\n**IMPORTANT - Cost Optimization:**\n- Use `jq` param to extract only needed fields from response\n- Example: `jq: \"{uuid: uuid, name: name}\"`\n\n**Output format:** TOON (default) or JSON (`outputFormat: \"json\"`)\n\n**Common operations:**\n\n1. **Update repository:** `/repositories/{workspace}/{repo}`\n   body: `{\"description\": \"...\", \"is_private\": true, \"has_issues\": true}`\n\n2. **Create/update file:** `/repositories/{workspace}/{repo}/src`\n   Note: Use multipart form data for file uploads (complex - prefer PATCH for metadata)\n\n3. **Update branch restriction:** `/repositories/{workspace}/{repo}/branch-restrictions/{id}`\n   body: `{\"kind\": \"push\", \"pattern\": \"main\", \"users\": [{\"uuid\": \"...\"}]}`\n\nThe `/2.0` prefix is added automatically. API reference: https://developer.atlassian.com/cloud/bitbucket/rest/","params":["path","queryParams","jq","outputFormat","body"]},{"name":"bb_patch","description":"Partially update Bitbucket resources. Returns TOON format by default.\n\n**IMPORTANT - Cost Optimization:** Use `jq` param to filter response fields.\n\n**Output format:** TOON (default) or JSON (`outputFormat: \"json\"`)\n\n**Common operations:**\n\n1. **Update PR title/description:** `/repositories/{workspace}/{repo}/pullrequests/{id}`\n   body: `{\"title\": \"New title\", \"description\": \"Updated description\"}`\n\n2. **Update PR reviewers:** `/repositories/{workspace}/{repo}/pullrequests/{id}`\n   body: `{\"reviewers\": [{\"uuid\": \"{user-uuid}\"}]}`\n\n3. **Update repository properties:** `/repositories/{workspace}/{repo}`\n   body: `{\"description\": \"New description\"}`\n\n4. **Update comment:** `/repositories/{workspace}/{repo}/pullrequests/{pr_id}/comments/{comment_id}`\n   body: `{\"content\": {\"raw\": \"Updated comment\"}}`\n\nThe `/2.0` prefix is added automatically. API reference: https://developer.atlassian.com/cloud/bitbucket/rest/","params":["path","queryParams","jq","outputFormat","body"]},{"name":"bb_delete","description":"Delete Bitbucket resources. Returns TOON format by default.\n\n**Output format:** TOON (default) or JSON (`outputFormat: \"json\"`)\n\n**Common operations:**\n\n1. **Delete branch:** `/repositories/{workspace}/{repo}/refs/branches/{branch_name}`\n2. **Delete PR comment:** `/repositories/{workspace}/{repo}/pullrequests/{pr_id}/comments/{comment_id}`\n3. **Decline PR:** `/repositories/{workspace}/{repo}/pullrequests/{id}/decline`\n4. **Remove PR approval:** `/repositories/{workspace}/{repo}/pullrequests/{id}/approve`\n5. **Delete repository:** `/repositories/{workspace}/{repo}` (caution: irreversible)\n\nNote: Most DELETE endpoints return 204 No Content on success.\n\nThe `/2.0` prefix is added automatically. API reference: https://developer.atlassian.com/cloud/bitbucket/rest/","params":["path","queryParams","jq","outputFormat"]},{"name":"bb_clone","description":"Clone a Bitbucket repository to your local filesystem using SSH (preferred) or HTTPS.\n\nProvide `repoSlug` and `targetPath` (absolute path). Clones into `targetPath/repoSlug`. SSH keys must be configured; falls back to HTTPS if unavailable.","params":["workspaceSlug","repoSlug","targetPath"]}],"toolsHash":"c3f1c8f4eeaf3aa776b83f28050cd0d6a9c0f5d5a1ba68bddbeeecac29843991","wrote":["/tmp/.mcp/data/mcp-server.84abdf4c-28dd-4a2d-a8d8-c468baa2bd84.log"],"host":{"commit":"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c","run":"https://github.com/itsHaddad/bragproof/actions/runs/43857070216"},"network":{"names":["registry.npmjs.org"],"conns":[]}},"summary":{"outcome":"started","needs":[],"contacts":[],"flags":[{"kind":"orders","tool":"bb_get","quote":"TOON format by default (30-60% fewer tokens than JSON). **IMPORTANT - Cost Optimization:** - ALWAYS use `jq` param to filter response fields. Unfiltered responses are"},{"kind":"orders","tool":"bb_post","quote":"urces. Returns TOON format by default (token-efficient). **IMPORTANT - Cost Optimization:** - Use `jq` param to extract only needed fields from response (e.g., `jq: \"{i"},{"kind":"orders","tool":"bb_put","quote":"resources (full update). Returns TOON format by default. **IMPORTANT - Cost Optimization:** - Use `jq` param to extract only needed fields from response - Example: `jq:"},{"kind":"orders","tool":"bb_patch","quote":"ate Bitbucket resources. Returns TOON format by default. **IMPORTANT - Cost Optimization:** Use `jq` param to filter response fields. **Output format:** TOON (default)"}],"tools":6,"wrote":1,"callsTried":0,"callsAnswered":0,"callContacts":[]},"history":[{"package":"@aashari/mcp-server-atlassian-bitbucket","version":"3.1.0","ranAt":"2026-11-16T11:25:56.387Z","outcome":"started","tools":6,"contacts":0,"flags":4,"serious":0,"toolsHash":"c3f1c8f4eeaf3aa776b83f28050cd0d6a9c0f5d5a1ba68bddbeeecac29843991"}],"page":"https://bragproof.smaverk.com/r/%40aashari/mcp-server-atlassian-bitbucket"}