bitbucket cloud and server api abstraction layer
Provides unified MCP protocol interface to both Bitbucket Cloud (REST API v2.0) and Bitbucket Server (REST API 1.0) backends through a single server implementation. Routes requests to appropriate API endpoint based on configured instance type, handling authentication differences (OAuth2 for Cloud, Basic/Token for Server) and API response normalization across versions.
Unique: Dual-backend MCP server supporting both Bitbucket Cloud and Server with unified interface — most MCP Bitbucket implementations only target Cloud, requiring separate tooling for Server instances
vs alternatives: Eliminates need for separate MCP servers or custom adapters when working with mixed Bitbucket deployments, reducing integration complexity for enterprises with hybrid infrastructure
pull request inspection and metadata extraction
Retrieves comprehensive pull request data including title, description, source/target branches, author, reviewers, approval status, and commit history through MCP tool calls. Implements pagination for large PR lists and normalizes response structure across Bitbucket Cloud and Server API versions to present consistent metadata regardless of backend.
Unique: Normalizes PR metadata across Bitbucket Cloud and Server APIs, handling structural differences in approval workflows and reviewer representation without exposing backend-specific quirks to the MCP client
vs alternatives: Provides consistent PR data structure for AI agents regardless of Bitbucket deployment, whereas direct API calls require conditional logic to handle Cloud vs Server response formats
repository browsing and file tree navigation
Enables traversal of repository directory structure and retrieval of file contents through MCP tools that map to Bitbucket's source API endpoints. Supports branch/tag selection, recursive directory listing with pagination, and file content retrieval with encoding handling. Implements caching or lazy-loading patterns to avoid excessive API calls when exploring large codebases.
Unique: Abstracts Bitbucket Cloud and Server source API differences to provide unified file browsing interface — handles different endpoint structures and response formats transparently
vs alternatives: Single MCP tool set works across both Bitbucket deployments without client-side branching logic, whereas direct API integration requires separate code paths for Cloud vs Server file retrieval
commit history and diff retrieval
Fetches commit logs with metadata (author, timestamp, message, parent commits) and retrieves diffs between commits or branches through MCP tools. Implements pagination for large commit histories and supports filtering by author, date range, or file path. Normalizes diff format across Bitbucket versions and handles merge commits appropriately.
Unique: Normalizes commit and diff APIs across Bitbucket Cloud and Server, handling differences in pagination, merge commit representation, and diff formatting without exposing backend-specific details
vs alternatives: Provides unified commit history and diff interface for AI agents across both Bitbucket deployments, whereas separate integrations would require duplicate logic for Cloud and Server API differences
branch and tag management operations
Provides MCP tools to list branches and tags, retrieve branch metadata (last commit, protection status), and potentially create/delete branches through Bitbucket API calls. Implements filtering and sorting for large branch lists and normalizes branch protection rules representation across Cloud and Server versions.
Unique: Abstracts branch protection rule differences between Bitbucket Cloud (branch permissions, merge checks) and Server (branch permissions, hooks) into unified interface
vs alternatives: Single MCP tool set handles branch operations across both Bitbucket deployments without client-side version detection, whereas direct API calls require conditional logic for Cloud vs Server branch protection APIs
mcp protocol request routing and authentication handling
Core MCP server implementation that routes incoming tool calls to appropriate Bitbucket API endpoints based on configured instance type (Cloud vs Server). Manages authentication state (OAuth2 tokens for Cloud, Basic/Token auth for Server), handles token refresh, and implements error handling with MCP-compliant error responses. Includes request validation and parameter marshaling.
Unique: Implements dual-backend MCP server with unified authentication abstraction — single server instance handles both Cloud OAuth2 and Server token/Basic auth without client-side branching
vs alternatives: Eliminates need for separate MCP servers or complex client-side authentication logic when working with mixed Bitbucket deployments, providing single integration point for both Cloud and Server