Skip to content

Bitbucket MCP Server

Secure, read-only Bitbucket access for VS Code Copilot, Cursor, and Claude Code — 37 tools, zero destructive operations.

37 Tools

Full coverage of Bitbucket Cloud API v2.0 across 8 categories — repositories, pull requests, branches, commits, pipelines, issues, search, and users.

Read-Only by Design

No write, delete, or modify operations are possible at any level. makeRequest() blocks all non-GET requests at runtime.

Flexible Output Formats

Every tool supports text, json, and toon (Token-Oriented Object Notation) output. TOON reduces LLM token consumption by 30–60%.

JMESPath Filtering

Apply JMESPath expressions to transform and filter response data on any of the 37 tools before output format conversion.

Tested & Production Ready

168 unit tests across 12 suites with 92.2% statement coverage. 31 of 37 tools verified against real Bitbucket API endpoints.

Integrations

Works out-of-the-box with VS Code GitHub Copilot, Cursor, and Claude Code via a simple JSON config snippet.

Terminal window
npm install -g @tugudush/bitbucket-mcp

Then add your MCP client config — see the Configuration guide for VS Code, Cursor, and Claude Code snippets.

CategoryTools
Repository Management8 tools — list workspaces, browse repos, read files
Pull Requests10 tools — PRs, comments, threads, diffs, CI statuses
Branches & Commits8 tools — branches, commits, tags, merge base
Diff & Comparison2 tools — unified diffs between commits
CI/CD Pipelines4 tools — pipeline runs, steps, and logs
Issues2 tools — issue listing and details
Search & Discovery1 tool — advanced code search with language filtering
User Information2 tools — user and authenticated user info