What can you do with this server?

This MCP server integrates with Bitbucket Server/Data Center, enabling AI assistants to manage repositories, pull requests, code reviews, branches, commits, and more. * Repository Management: List projects and repositories, browse file structures, read file contents, edit files, create/delete repositories, upload attachments, get file blame, list/create forks, and get server info. * Pull Requests: Create (including cross-repo/fork PRs and drafts), get details, update, merge (multiple strategies), decline, list, and get activity, diffs, commits, and commits-to-PR mapping. Also list dashboard PRs across all repos. * Code Review: Manage PR comments (create, edit, delete, react; supports inline anchoring, draft state, tasks, threaded replies, resolve/unresolve) and reviews (approve, unapprove, publish). * Branches & Commits: List branches, create/delete branches (with default branch safety check), list commits, get commit details, compare refs, and list/create/delete/get tags. * Search & Insights: Search code and files across repos, get Code Insights reports and annotations (e.g., SonarQube), and get CI build statuses. * Users: Get user profiles and search users. * Labels: List, add, and remove repository labels. * Webhooks: List, create, update, and delete repository webhooks. * Commit Comments: List, create, edit, and delete comments on specific commits. * Repository Settings: Manage default reviewer conditions, branch restrictions, repository hooks (list/enable/disable/configure), merge checks, reviewer groups, and secret scanning allowlist rules. * SSH & GPG Keys: List, add, and delete SSH and GPG keys for the authenticated user. * Deployments: Get, create, and delete deployment records for commits. * Prompts & Resources: Built-in review-pr prompt for guided PR reviews; bitbucket://projects resource providing a cached list of accessible projects as ambient context.

Which integrations are available for this server?

Provides tools for interacting with Bitbucket Server (or Data Center) including repository management, pull request operations, code review, and branch/commit management.

How do I use bitbucket-server-mcp?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@bitbucket-server-mcp list my open pull requests" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

bitbucket-server-mcp

by Upendrasengar

Overview Schema Source Related Servers Discussions Admin

TypeScript

Remote

Quickstart

Or via Claude Code:

claude mcp add bitbucket \
  -e BITBUCKET_URL=https://your-bitbucket-server.com \
  -e BITBUCKET_TOKEN=your-token \
  -- npx -y @upendra_sengar/bitbucket-server-mcp

Related MCP server: Bitbucket MCP

Requirements

Bitbucket Server / Data Center 7.21+ (the E2E suite covers 7.21, 8.5, 8.9, 8.19, 9.4 and 10.2).
One of:
- Node.js >= 22.14 (via npx)
- Bun (via bunx)
- Docker

Installation

Add to your workspace .vscode/mcp.json:

{
  "servers": {
    "bitbucket": {
      "command": "npx",
      "args": ["-y", "@upendra_sengar/bitbucket-server-mcp"],
      "env": {
        "BITBUCKET_URL": "https://your-bitbucket-server.com",
        "BITBUCKET_TOKEN": "your-access-token"
      }
    }
  }
}

These clients all use the same mcpServers format. Add the JSON below to the config file for your client:

Client	Config file
Claude Desktop	`~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows)
Cursor	`~/.cursor/mcp.json` (one-click install)
Windsurf	`~/.codeium/windsurf/mcp_config.json`
JetBrains	Settings > Tools > AI Assistant > MCP, or `~/.junie/mcp/mcp.json`
Neovim	mcphub.nvim `mcpservers.json`

{
  "mcpServers": {
    "bitbucket": {
      "command": "npx",
      "args": ["-y", "@upendra_sengar/bitbucket-server-mcp"],
      "env": {
        "BITBUCKET_URL": "https://your-bitbucket-server.com",
        "BITBUCKET_TOKEN": "your-access-token"
      }
    }
  }
}

Add to your Zed settings (~/.config/zed/settings.json on Linux, ~/Library/Application Support/Zed/settings.json on macOS):

{
  "context_servers": {
    "bitbucket": {
      "source": "custom",
      "command": "npx",
      "args": ["-y", "@upendra_sengar/bitbucket-server-mcp"],
      "env": {
        "BITBUCKET_URL": "https://your-bitbucket-server.com",
        "BITBUCKET_TOKEN": "your-access-token"
      }
    }
  }
}

For environments without Node.js:

{
  "mcpServers": {
    "bitbucket": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "BITBUCKET_URL=https://your-bitbucket-server.com",
        "-e", "BITBUCKET_TOKEN=your-access-token",
        "ghcr.io/upendrasengar/bitbucket-server-mcp"
      ]
    }
  }
}

Or build locally: docker build -t bitbucket-mcp .

TIP

Bun users can replace npx -y with bunx in any of the configs above.

Tools

Repositories

Tool	Description
`list_projects`	List all accessible Bitbucket projects
`list_repositories`	List repositories in a project
`browse_repository`	Browse files and directories
`get_file_content`	Read file contents with pagination
`upload_attachment`	Upload a local file and get a markdown reference for PR comments
`edit_file`	Edit a file by committing a new version via the REST API
`get_server_info`	Get Bitbucket Server version and properties
`get_file_blame`	Get line-by-line blame/history for a file
`create_repository`	Create a new repository
`delete_repository`	Delete a repository (irreversible)

Pull Requests

Tool	Description
`create_pull_request`	Create a PR, including cross-repo from forks (`sourceProject`/`sourceRepository`) and drafts (`draft: true`). Auto-fetches default reviewers unless `includeDefaultReviewers: false`.
`get_pull_request`	Get PR details
`update_pull_request`	Safely update title, description, or reviewers (read-modify-write, preserves fields not explicitly changed)
`merge_pull_request`	Merge a PR with optional strategy (`no-ff`, `ff`, `ff-only`, `squash`, `rebase-no-ff`, `rebase-ff-only`, `squash-ff-only`)
`decline_pull_request`	Decline a PR
`list_pull_requests`	List PRs with filtering by state, author, direction
`list_dashboard_pull_requests`	List PRs across all repos for the authenticated user, filtered by role (`AUTHOR`/`REVIEWER`/`PARTICIPANT`), state, and review status
`get_pull_request_activity`	Get PR activity timeline, filtered by type (`all`, `reviews`, `comments`)
`get_diff`	Get PR diff with per-file truncation support. Use `stat: true` for a lightweight summary of changed files instead of the full diff.
`get_pull_request_commits`	List commits in a pull request
`get_commit_pull_requests`	List pull requests containing a specific commit

Code Review

Tool	Description
`manage_comment`	Unified create/edit/delete for PR comments. Supports inline anchoring (`filePath`/`line`/`lineType`), draft state (`state: PENDING`), task creation (`severity: BLOCKER`), threaded replies (`parentId`), and resolve/unresolve (`state: RESOLVED`/`OPEN`).
`manage_review`	Unified approve/unapprove/publish. Publish transitions all `PENDING` comments to visible and optionally sets `participantStatus` (`APPROVED`/`NEEDS_WORK`).

Branches & Commits

Tool	Description
`list_branches`	List branches with default branch detection
`list_commits`	Browse commit history with branch and author filtering
`manage_branches`	Create or delete branches (safety check prevents deleting default branch)
`get_commit`	Get details of a specific commit by its ID
`compare_refs`	List commits reachable from one ref but not another
`list_tags`	List tags in a repository
`manage_tags`	Create or delete tags
`get_tag`	Get details of a specific tag by its name

Search & Insights

Tool	Description
`search`	Search code and files across repositories
`get_code_insights`	Fetch Code Insights reports (SonarQube, security scans) and annotations
`get_build_status`	Get CI build status (state, name, URL) by commit ID or PR. When using prId, resolves the latest commit automatically.

Forks

Tool	Description
`list_forks`	List forks of a repository
`fork_repository`	Fork a repository into a target project

Users

Tool	Description
`get_user_profile`	Get a user profile by slug
`search_users`	Search users by filter query

Labels

Tool	Description
`list_labels`	List labels for a repository
`manage_labels`	Add or remove repository labels

Webhooks

Tool	Description
`list_webhooks`	List webhooks for a repository
`manage_webhooks`	Create, update, or delete webhooks

Commit Comments

Tool	Description
`list_commit_comments`	List comments on a specific commit
`manage_commit_comments`	Create, edit, or delete comments on a commit

Repository Settings

Tool	Description
`list_default_reviewer_conditions`	List default reviewer conditions
`list_branch_restrictions`	List branch permission restrictions
`list_repository_hooks`	List repository hooks and their status
`manage_repository_hooks`	Enable, disable, or configure repository hooks
`list_merge_checks`	List merge check configurations
`manage_merge_checks`	Configure merge check settings
`list_reviewer_groups`	List reviewer groups
`manage_reviewer_groups`	Create or delete reviewer groups
`list_secret_scanning_rules`	List secret scanning allowlist rules (8.5+)

Keys

Tool	Description
`list_ssh_keys`	List SSH keys for the authenticated user
`manage_ssh_keys`	Add or delete SSH keys
`list_gpg_keys`	List GPG keys for the authenticated user
`manage_gpg_keys`	Add or delete GPG keys

Prompts

Prompt	Description
`review-pr`	Step-by-step workflow for reviewing a PR: fetch details, read diff, check CI, create draft comments, and publish the review. Invoke via `/bitbucket:review-pr` in Claude Code. No arguments needed; the LLM asks for the PR interactively. You can add context, e.g. `/bitbucket:review-pr PR #42 in my-repo`.

Resources

Resource	URI	Description
`projects`	`bitbucket://projects`	Cached list of all accessible projects (5 min TTL). Useful as ambient context without explicit tool calls.

Configuration

Environment Variables

Variable	Required	Description
`BITBUCKET_URL`	Yes	Base URL of your Bitbucket Server instance
`BITBUCKET_TOKEN`	Yes*	Personal access token
`BITBUCKET_USERNAME`	Yes*	Username for basic auth
`BITBUCKET_PASSWORD`	Yes*	Password for basic auth
`BITBUCKET_DEFAULT_PROJECT`	No	Default project key when not specified in tool calls
`BITBUCKET_READ_ONLY`	No	Set to `true` to disable all write operations
`BITBUCKET_CUSTOM_HEADERS`	No	Extra headers for all requests (`Key=Value,Key2=Value2`). Useful for Zero Trust tokens.
`BITBUCKET_DIFF_MAX_LINES_PER_FILE`	No	Max lines per file in diffs. Set to `0` for no limit.
`BITBUCKET_CACHE_TTL`	No	Cache duration in seconds (default: 300). Set to `0` to disable caching.
`BITBUCKET_ENABLED_TOOLS`	No	Comma-separated list of tool names to enable. If not set, all tools are available.
`BITBUCKET_STARTUP_HEALTHCHECK`	No	Set to `true` to run a connectivity check against Bitbucket on startup (default: `false`).
`HTTPS_PROXY`	No	HTTP/HTTPS proxy URL (e.g. `http://proxy.corp.com:8080`). Useful in corporate environments.
`NODE_EXTRA_CA_CERTS`	No	Path to a PEM file with additional CA certificates. Use when Bitbucket is behind a self-signed TLS cert.

*Either BITBUCKET_TOKEN or both BITBUCKET_USERNAME and BITBUCKET_PASSWORD are required.

Token Permissions

The Personal Access Token needs the following Bitbucket permissions depending on what you intend to do:

Permission	Required for
Project read	`list_projects`, `list_repositories`, `browse_repository`, `get_file_content`
Repository read	All read tools (branches, commits, tags, diff, blame)
Repository write	`edit_file`, `manage_branches`, `manage_tags`, `create_repository`, `delete_repository`
Pull request read	`list_pull_requests`, `get_pull_request`, `get_diff`, `get_pull_request_commits`
Pull request write	`create_pull_request`, `update_pull_request`, `merge_pull_request`, `decline_pull_request`, `manage_comment`, `manage_review`

For a read-only setup, Project read + Repository read + Pull request read is sufficient.

Read-Only Mode

Set BITBUCKET_READ_ONLY=true to restrict the server to read-only operations. All create_*, update_*, delete_*, manage_*, merge_*, decline_*, fork_*, upload_*, and edit_* tools are disabled.

Tool Filtering

Set BITBUCKET_ENABLED_TOOLS to load only specific tools, reducing context window usage:

BITBUCKET_ENABLED_TOOLS=get_pull_request,get_diff,manage_comment,manage_review

Startup Healthcheck

When BITBUCKET_STARTUP_HEALTHCHECK=true, the server probes /rest/api/1.0/application-properties on startup and logs whether Bitbucket is reachable. If not, it logs a diagnostic line referencing the relevant env vars (BITBUCKET_URL, BITBUCKET_TOKEN, HTTPS_PROXY, NODE_EXTRA_CA_CERTS) without blocking the server. Useful for debugging connectivity issues before the first tool call fails with a generic error.

BITBUCKET_STARTUP_HEALTHCHECK=true

Response Curation

Read tools return compact responses by default, keeping only the fields an AI assistant typically needs. Every read tool accepts a fields parameter to customize:

Omit fields: returns a curated summary (e.g. PR id, title, state, author, branches, reviewers, task count)
fields: "*all": returns the complete raw Bitbucket API response
fields: "id,title,author.user.name": returns exactly those fields (dot notation for nested paths)

Caching

The server caches frequently accessed data in memory (project lists, repository metadata, default reviewers) to reduce API calls. The cache uses LRU eviction (max 500 entries) so memory stays bounded, and write operations automatically invalidate related entries.

By default, cached entries expire after 5 minutes. Configure with BITBUCKET_CACHE_TTL (in seconds), or set to 0 to disable caching entirely.

Bitbucket Cloud

This server targets Bitbucket Server / Data Center only. Bitbucket Cloud (bitbucket.org) uses a different REST API and is not supported.

Usage Examples

List open PRs assigned to you for review

list_dashboard_pull_requests with role=REVIEWER, state=OPEN

Create an inline draft comment on a PR

manage_comment with prId=42, filePath="src/auth.ts", line=17, lineType="ADDED",
text="This token is never invalidated — add expiry.", state="PENDING"

Then publish all draft comments at once:

manage_review with prId=42, action="publish", participantStatus="NEEDS_WORK"

Get a lightweight diff summary without reading every line

get_diff with prId=42, stat=true

Enable only the tools you need (reduces context window usage)

BITBUCKET_ENABLED_TOOLS=get_pull_request,get_diff,manage_comment,manage_review

Troubleshooting

UNABLE_TO_VERIFY_LEAF_SIGNATURE or self-signed certificate errors Set NODE_EXTRA_CA_CERTS=/path/to/your-ca-bundle.pem to point Node.js at your internal CA.

403 Forbidden on write operations Your token is missing a write-level permission. See the Token Permissions table above for the exact scope needed.

Server starts but can't reach Bitbucket Enable BITBUCKET_STARTUP_HEALTHCHECK=true — it will log a diagnostic line showing which env vars are missing or misconfigured. In corporate environments also set HTTPS_PROXY.

401 Unauthorized Token auth and basic auth are mutually exclusive. Set either BITBUCKET_TOKEN alone, or both BITBUCKET_USERNAME + BITBUCKET_PASSWORD. Having all three set will cause unpredictable behaviour — remove whichever pair you don't intend to use.

Tool not found / unexpected behaviour on older Bitbucket versions Some tools require Bitbucket 8.5+ (e.g. list_secret_scanning_rules). Check the tool description in the Tools section for version requirements. The E2E suite covers 7.21, 8.5, 8.9, 8.19, 9.4, and 10.2.

Contributing

See CONTRIBUTING.md for development setup, architecture overview, and how to add new tools.

License

Apache 2.0

Available Tools

59 tools

browse_repositoryC

Read-onlyIdempotent

Browse files and directories in a repository to understand project structure.

Inputs: repository (required), path, limit, branch, +1 more.

compare_refsA

Read-onlyIdempotent

Compare two refs and list commits accessible from to but not from from. Supports custom field selection via the fields param ('*all' for full raw response, 'id,message,author.name' for a custom subset).

Inputs: repository (required), to, from, limit, +3 more.

create_pull_requestA

Create a new pull request. Supports cross-repo PRs via sourceProject/sourceRepository and automatic default reviewer merging.

Inputs: title (required), repository (required), sourceBranch (required), targetBranch (required), +7 more.

create_repositoryB

Create a new repository in a project.

Inputs: name (required), project, description, defaultBranch.

decline_pull_requestA

Destructive

Decline a pull request. Fetches the current version automatically for optimistic locking.

Inputs: prId (required), repository (required), message, project.

delete_repositoryA

Destructive

Delete a repository. This action is irreversible.

Inputs: repository (required), project.

edit_fileA

Edit a file in a repository by committing a new version via the Bitbucket REST API. Returns the commit metadata.

Inputs: branch (required), content (required), message (required), filePath (required), +4 more.

fork_repositoryA

Fork a repository into a target project. Creates a copy of the source repository in the specified target project.

Inputs: repository (required), name, project, target_project.

get_build_statusA

Read-onlyIdempotent

Get CI build status for a commit or pull request. When prId is provided, automatically resolves the latest commit. Returns build state (SUCCESSFUL, FAILED, INPROGRESS), name, and URL to the CI build.

Inputs: prId, project, commitId, repository.

get_code_insightsA

Read-onlyIdempotent

Get code insight reports and their annotations for a pull request. Shows build results, code quality, and other analysis.

Inputs: prId (required), repository (required), fields, project, +3 more.

get_commitA

Read-onlyIdempotent

Get details of a specific commit by its ID. Supports custom field selection via the fields param ('*all' for full raw response, 'id,message,author.name' for a custom subset).

Inputs: commitId (required), repository (required), fields, project.

get_commit_pull_requestsA

Read-onlyIdempotent

List pull requests that contain a specific commit. Returns the PRs that include the given commit.

Inputs: commitId (required), repository (required), limit, start, +2 more.

get_diffA

Read-onlyIdempotent

Get the diff of a pull request. Use stat=true for a lightweight summary of changed files (and line counts if the server supports it) instead of the full diff.

Inputs: prId (required), repository (required), stat, project, +3 more.

get_file_blameA

Read-onlyIdempotent

Get blame/history information for a file. Returns line-by-line commit authorship data.

Inputs: filePath (required), repository (required), branch, project.

get_file_contentA

Read-onlyIdempotent

Read file contents from a repository with pagination support for large files.

Inputs: filePath (required), repository (required), limit, start, +2 more.

get_pull_requestA

Read-onlyIdempotent

Get details of a specific pull request including status, reviewers, and metadata. Supports custom field selection via the fields param ('*all' for full raw response, 'id,title,state' for a custom subset).

Inputs: prId (required), repository (required), fields, project, +2 more.

get_pull_request_activityA

Read-onlyIdempotent

Get activity feed for a pull request. Optionally filter to only reviews or comments.

Inputs: prId (required), repository (required), limit, start, +4 more.

get_pull_request_commitsA

Read-onlyIdempotent

List commits for a specific pull request. Returns the commits that are part of the pull request with pagination support.

Inputs: prId (required), repository (required), limit, start, +2 more.

get_server_infoA

Read-onlyIdempotent

Get Bitbucket Server version and properties. Useful to check connectivity and server version.

Inputs: no named parameters.

get_tagA

Read-onlyIdempotent

Get details of a specific tag by its name. Supports custom field selection via the fields param ('*all' for full raw response, 'id,displayId,hash' for a custom subset).

Inputs: name (required), repository (required), fields, project.

get_user_profileA

Read-onlyIdempotent

Get a Bitbucket user profile by user slug. Returns user details including display name, email, and active status.

Inputs: userSlug (required), fields.

list_branchesA

Read-onlyIdempotent

List branches in a repository. Also returns the default branch when available. Supports custom field selection via the fields param ('*all' for full raw response, 'displayId,latestCommit' for a custom subset).

Inputs: repository (required), limit, start, fields, +2 more.

list_branch_restrictionsA

Read-onlyIdempotent

List branch restrictions for a repository. These control which users/groups can push to or delete specific branches or branch patterns.

Inputs: repository (required), limit, start, project.

list_commit_commentsA

Read-onlyIdempotent

Get comments for a specific commit. Returns all comments on the commit with pagination support.

Inputs: commitId (required), repository (required), limit, start, +2 more.

list_commitsA

Read-onlyIdempotent

List commits in a repository, optionally filtered by branch and author. Supports custom field selection via the fields param ('*all' for full raw response, 'id,message,author.name' for a custom subset).

Inputs: repository (required), limit, start, author, +3 more.

list_dashboard_pull_requestsA

Read-onlyIdempotent

Get pull requests from the authenticated user dashboard. No project/repo needed. Supports custom field selection via the fields param ('*all' for full raw response, 'id,title,state' for a custom subset).

Inputs: role, limit, order, start, +4 more.

list_default_reviewer_conditionsA

Read-onlyIdempotent

List default reviewer conditions for a repository. These conditions determine which users are automatically added as reviewers to pull requests.

Inputs: repository (required), fields, project.

list_forksA

Read-onlyIdempotent

List forks of a repository. Supports custom field selection via the fields param ('*all' for full raw response, 'slug,name' for a custom subset).

Inputs: repository (required), limit, start, fields, +1 more.

list_gpg_keysA

Read-onlyIdempotent

List GPG keys for the authenticated user.

Inputs: limit, start, userSlug.

list_labelsB

Read-onlyIdempotent

List labels for a repository.

Inputs: repository (required), limit, start, project.

list_merge_checksA

Read-onlyIdempotent

List merge check configurations for a repository. Merge checks control conditions that must be met before a pull request can be merged.

Inputs: repository (required), project.

list_projectsA

Read-onlyIdempotent

List all Bitbucket projects you have access to. Use this first to discover project keys. Supports custom field selection via the fields param ('*all' for full raw response, 'key,name' for a custom subset).

Inputs: limit, start, fields.

list_pull_requestsA

Read-onlyIdempotent

List pull requests in a repository. Supports filtering by state, direction, order, and client-side author filtering. Supports custom field selection via the fields param ('*all' for full raw response, 'id,title,state' for a custom subset).

Inputs: repository (required), limit, order, start, +5 more.

list_repositoriesA

Read-onlyIdempotent

List repositories in a project. Use this to find repository slugs for other operations. Supports custom field selection via the fields param ('*all' for full raw response, 'slug,name' for a custom subset).

Inputs: limit, start, fields, project.

list_repository_hooksA

Read-onlyIdempotent

List repository hooks and their enabled/disabled state.

Inputs: repository (required), limit, start, project.

list_reviewer_groupsA

Read-onlyIdempotent

List reviewer groups configured for a repository.

Inputs: repository (required), fields, project.

list_secret_scanning_rulesA

Read-onlyIdempotent

List secret scanning allowlist rules for a repository. Requires Bitbucket Server 8.5+.

Inputs: repository (required), fields, project.

list_ssh_keysA

Read-onlyIdempotent

List SSH keys for the authenticated user.

Inputs: limit, start, userSlug.

list_webhooksA

Read-onlyIdempotent

List webhooks configured for a repository.

Inputs: repository (required), limit, start, fields, +1 more.

manage_branchesA

Destructive

Manage branches in a repository. Actions: "create" (create a new branch), "delete" (delete a branch). Refuses to delete the default branch.

Inputs: action (required), branch (required), repository (required), project, +1 more.

manage_commentA

Manage pull request comments. Actions: "create" (general, inline, threaded, or tasks), "edit" (update text/severity/state/threadResolved), "delete", "react" (add emoji reaction), "unreact" (remove reaction). state: RESOLVED toggles the task checkbox on a BLOCKER comment; threadResolved: true closes the conversation (the "Resolve" button in the UI). They are independent and can be passed together.

Inputs: prId (required), action (required), repository (required), line, +13 more.

manage_commit_commentsC

Manage comments on a commit. Actions: "create" (add a new comment), "edit" (update an existing comment), "delete" (remove a comment).

Inputs: action (required), commitId (required), repository (required), text, +3 more.

manage_deploymentsA

Manage deployments for a commit. Actions: "get" (retrieve a deployment), "create" (record a new deployment), "delete" (remove a deployment). GET requires key, environmentKey, and deploymentSequenceNumber. POST body requires deploymentSequenceNumber, description, displayName, environment (with displayName, key, optional type), key, state, and optional url. DELETE requires key, environmentKey, and deploymentSequenceNumber.

Inputs: action (required), commitId (required), repository (required), key, +9 more.

manage_gpg_keysB

Manage GPG keys for the authenticated user. Actions: "add" (add a key), "delete" (remove a key).

Inputs: action (required), text, keyId.

manage_labelsB

Manage repository labels. Actions: "add" (create a new label), "remove" (delete a label).

Inputs: name (required), action (required), repository (required), project.

manage_merge_checksB

Configure merge check settings for a repository.

Inputs: hookKey (required), settings (required), repository (required), project.

manage_repository_hooksA

Manage repository hook settings. Actions: "enable" (enable a hook), "disable" (disable a hook), "configure" (set hook settings).

Inputs: action (required), hookKey (required), repository (required), project, +1 more.

manage_reviewA

Approve, unapprove, or publish a review on a pull request. Use "approve" to approve, "unapprove" to remove your approval, and "publish" to submit a review with an optional overview comment and status.

Inputs: prId (required), action (required), repository (required), project, +2 more.

manage_reviewer_groupsC

Manage reviewer groups for a repository. Actions: "create" (create a group), "delete" (remove a group).

Inputs: name (required), action (required), repository (required), project, +2 more.

manage_ssh_keysA

Manage SSH keys for the authenticated user. Actions: "add" (add a key), "delete" (remove a key).

Inputs: action (required), text, keyId.

manage_tagsB

Destructive

Manage tags in a repository. Actions: "create" (create a new tag pointing to a commit), "delete" (delete a tag by name).

Inputs: name (required), action (required), repository (required), message, +2 more.

manage_webhooksC

Manage repository webhooks. Actions: "create" (add a new webhook), "update" (modify an existing webhook), "delete" (remove a webhook).

Inputs: action (required), repository (required), url, name, +4 more.

merge_pull_requestA

Destructive

Merge an approved pull request. Fetches the current version automatically for optimistic locking.

Inputs: prId (required), repository (required), message, project, +1 more.

searchA

Read-onlyIdempotent

Search for code or files across Bitbucket repositories. Supports filtering by project, repository, and search type. Supports custom field selection via the fields param ('*all' for full raw response, 'file,hitCount' for a custom subset).

Inputs: query (required), type, limit, start, +3 more.

search_emoticonsA

Read-onlyIdempotent

Search available emoticons for comment reactions. Returns matching shortcut names to use with manage_comment react/unreact.

Inputs: query (required).

search_usersA

Read-onlyIdempotent

Search Bitbucket users by filter query. Returns matching users.

Inputs: filter (required), limit, start, fields.

update_pull_requestA

Idempotent

Update a pull request (title, description, target branch, or reviewers). Only changed fields are applied; reviewers are preserved if not provided.

Inputs: prId (required), repository (required), title, project, +3 more.

upload_attachmentB

Upload a file attachment to a repository. Returns a markdown reference to embed in PR comments or descriptions.

Inputs: filePath (required), repository (required), project.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

TDQS

A3.5/5.0

Scored 2026-07-10 21:35 across 59 tools

Disambiguation4/5

Most tools have distinct purposes, but with 59 tools, some overlap may occur (e.g., multiple 'manage' tools for different resources). However, naming and descriptions help differentiate.

Naming Consistency5/5

All tools follow a consistent verb_noun pattern (e.g., list_branches, create_pull_request, manage_webhooks) with no mixing of conventions.

Tool Count2/5

59 tools is excessive for a typical server. While the scope covers many Bitbucket features, many tools are narrow (e.g., manage_gpg_keys, list_ssh_keys) and could be consolidated, leading to a heavy surface.

Completeness4/5

The tool set covers a wide range of Bitbucket Server operations including browsing, commits, PRs, branches, tags, hooks, keys, and more. Minor gaps exist (e.g., no tool for creating projects directly), but overall coverage is strong.

Maintenance

ActivityInactive

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

Robinson MCP for GitHub
com.robinsonaisystems
Operate GitHub from your AI assistant: repos, PRs, issues, Actions. Previews and read-only mode.
Version Control Developer Tools CI/CD & DevOps
1
https://github.robinsonaisystems.com/api/mcp
smithery-ai-github
ai.smithery
Access the GitHub API, enabling file operations, repository management, search functionality, and…
Version Control Developer Tools CI/CD & DevOps
295
https://server.smithery.ai/@smithery-ai/github/mcp
KukGit
io.github.amithkukllod777
Read and write KukGit repositories, files, issues and pull requests from an AI assistant.
Version Control Project Management Developer Tools
1
https://git.kuklabs.com/mcp
searchcodeA
com.searchcode
Code intelligence for LLMs. Analyze, search, and retrieve code from any public git repository.
Search Code Analysis Version Control
72
https://api.searchcode.com/v1/mcp

Related MCP Servers

Bitbucket MCP
Version Control CI/CD & DevOps Developer Tools
Nicholas80932
A
license
Not graded
quality
A
maintenance
Enables AI assistants to interact with Bitbucket Cloud and Server APIs to list and retrieve repositories, fetch and create pull requests, and manage related resources through natural language.
Updated a month ago (2026-10-16 11:21 UTC)
5,856 npm
MIT
Bitbucket MCP
Version Control Developer Tools CI/CD & DevOps
Berk19060
A
license
Not graded
quality
A
maintenance
Enables AI assistants to interact with Bitbucket Cloud and Server APIs, including listing and retrieving repositories and fetching, creating, and viewing pull requests.
Updated a month ago (2026-10-17 21:26 UTC)
5,856 npm
MIT
Bitbucket MCP
Version Control CI/CD & DevOps Developer Tools
HugoKwon7312
A
license
Not graded
quality
A
maintenance
Enables AI assistants to interact with Bitbucket repositories and pull requests, including listing repositories, retrieving repository details, fetching pull requests, and creating pull requests through Bitbucket Cloud and Server APIs.
Updated a month ago (2026-10-17 21:58 UTC)
5,856 npm
MIT
Bitbucket MCP
Version Control CI/CD & DevOps Developer Tools
AnnaButt9058
A
license
Not graded
quality
A
maintenance
Enables AI assistants to interact with Bitbucket repositories and pull requests via Bitbucket Cloud and Server APIs, supporting repository listing and retrieval plus pull request creation, viewing, and filtering.
Updated a month ago (2026-10-18 05:00 UTC)
5,856 npm
MIT