MCP.so
Sign In

Bitbucket Server MCP Server

@garc33

Basic information

Category

Version Control

License

Apache-2.0

Transports

stdio

Author

garc33

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

1

What are the runtime requirements?

Node.js version 16 or higher is required.

2

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.

3

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.

4

Does search work across all branches?

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

5

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