Bitbucket Server MCP Server

@garc33

Repository

Basic information

About Bitbucket Server MCP Server

No overview available yet

#bitbucket #mcp#pull-request-management

Bitbucket Server MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "bitbucket-server-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@garc33/bitbucket-server-mcp-server",
        "--client",
        "claude"
      ]
    }
  }
}

Bitbucket Server MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is Bitbucket Server MCP?

Bitbucket Server MCP is a Model Context Protocol (MCP) server that provides tools and resources for Bitbucket Server Pull Request management through the MCP protocol. It enables AI assistants to interact with the Bitbucket Server API for code review, branch management, and repository exploration.

How to use Bitbucket Server MCP?

Install via Smithery (npx -y @smithery/cli install @garc33/bitbucket-server-mcp-server --client claude) or manually (npm install followed by npm run build). Configure environment variables such as BITBUCKET_DEFAULT_PROJECT and BITBUCKET_CUSTOM_HEADERS for Zero Trust tokens. Tools are invoked through the MCP protocol by an AI client.

Key features of Bitbucket Server MCP

Pull request creation, update, merge, and decline
PR approval and unapproval
Branch listing and deletion (including merged branches)
Code and file search across repositories
File content reading with pagination
Comment management and threaded replies
Repository and project discovery
Commit history browsing with filters
Custom HTTP headers for advanced authentication

Use cases of Bitbucket Server MCP

Automate PR creation and review workflows
Search code and files across multiple projects
Retrieve and analyze pull request diffs
Manage branch lifecycle (list, delete merged branches)
Track PR review progress and activities

Frequently asked questions

What are the runtime requirements?

Node.js version 16 or higher is required.

How do I configure the server?

Set environment variables: `BITBUCKET_DEFAULT_PROJECT` for a default project key, `BITBUCKET_CUSTOM_HEADERS` for custom HTTP headers (e.g., Zero Trust tokens), and `BITBUCKET_DIFF_MAX_LINES_PER_FILE` to control diff output limits.

What authentication methods are supported?

The server supports custom HTTP headers via the `BITBUCKET_CUSTOM_HEADERS` environment variable for proxies or Zero Trust tokens. Authentication details for the Bitbucket Server API are handled separately.

Does search work across all branches?

No, the search tool only works on the default branch of repositories.

Can I handle large diffs?

Yes, the `get_diff` tool supports per-file truncation via `maxLinesPerFile` or the `BITBUCKET_DIFF_MAX_LINES_PER_FILE` environment variable.

Comments

More Version Control MCP servers

Integrate MCP with GitHub Copilot

skills

Learn how to use MCP Servers with GitHub Copilot

225

Git MCP Server

cyanheads

A Git MCP server for AI agents. STDIO & Streamable HTTP.

225

Gerrit Review MCP Server

cayirtepeomer

This MCP server provides integration with Gerrit code review system, allowing AI assistants to review code changes and their details through a simple interface.

GitLab

modelcontextprotocol

Model Context Protocol Servers

88.1K

Kin

Troy Fortin, Jr. (Firelock, LLC)

The system of record for AI-written software. A persistent graph of entities, relationships, changes, and provenance, so humans and AI agents see what a change touches before it merges. Beside Git today.