Bitbucket MCP
io.github.matanyemini/bitbucket-mcp
17 toolsSTDIOregistry active
Summary
Connects your Claude conversations directly to Bitbucket Cloud and Server instances, letting you query repositories, pull requests, issues, and pipelines without leaving your workflow. You'd reach for this when you're doing code reviews, tracking down build failures, or need to reference ticket details while coding. The integration covers both Bitbucket's cloud and self-hosted versions, so it works whether your team is on Atlassian's infrastructure or running your own servers. Useful for keeping context when you're bouncing between writing code and managing the surrounding infrastructure of branches, PRs, and CI/CD status.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Tools
Public tool metadata for what this MCP can expose to an agent.
17 tools
BITBUCKET_CREATE_BRANCHCreates a new branch in a Bitbucket repository from a target commit hash; the branch name must be unique, adhere to Bitbucket's naming conventions, and not include the 'refs/heads/' prefix.4 params
Creates a new branch in a Bitbucket repository from a target commit hash; the branch name must be unique, adhere to Bitbucket's naming conventions, and not include the 'refs/heads/' prefix.
Parameters* required
namestringThe name for the new branch (e.g., 'feature/new-login', 'bugfix/issue-123'). Important: Do not include the 'refs/heads/' prefix.
repo_slugstringThe slug or UUID of the repository where the branch will be created. This is usually the repository's name in URL-friendly format.
target_hashstringThe full commit hash (SHA1) from which the new branch will be created. This commit must exist in the repository.
workspacestringThe workspace ID or UUID that owns the repository. This can typically be found in the URL of your Bitbucket workspace.
BITBUCKET_CREATE_ISSUECreates a new issue in a Bitbucket repository, setting the authenticated user as reporter; ensures assignee (if provided) has repository access, and that any specified milestone, version, or component IDs exist.11 params
Creates a new issue in a Bitbucket repository, setting the authenticated user as reporter; ensures assignee (if provided) has repository access, and that any specified milestone, version, or component IDs exist.
Parameters* required
assigneestringBitbucket username of the assignee. The assignee must have repository access.
component_idintegerNumeric ID of an existing component to associate with this issue.
contentstringDetailed description for the new issue.
due_onstringDue date for the issue in ISO 8601 format (e.g., 'YYYY-MM-DDTHH:mm:ssZ').
kindstringType of the issue (e.g., 'bug', 'enhancement', 'proposal', 'task').
milestone_idintegerNumeric ID of an existing milestone to associate with this issue.
prioritystringPriority level of the issue (e.g., 'trivial', 'minor', 'major', 'critical', 'blocker').
repo_slugstringThe slug of the Bitbucket repository.
titlestringTitle for the new issue.
version_idintegerNumeric ID of an existing version to associate with this issue.
workspacestringThe ID or slug of the Bitbucket workspace.
BITBUCKET_CREATE_ISSUE_COMMENTAdds a new comment with markdown support to an existing Bitbucket issue.4 params
Adds a new comment with markdown support to an existing Bitbucket issue.
Parameters* required
contentstringThe raw text content for the comment. This content supports markdown formatting, which Bitbucket will then render.
issue_idstringThe unique identifier of the issue on which the comment will be posted.
repo_slugstringThe slug (URL-friendly version) of the repository name.
workspacestringThe ID or slug of the workspace or user that owns the repository.
BITBUCKET_CREATE_PULL_REQUESTCreates a new pull request in a specified Bitbucket repository, ensuring the source branch exists and is distinct from the (optional) destination branch.8 params
Creates a new pull request in a specified Bitbucket repository, ensuring the source branch exists and is distinct from the (optional) destination branch.
Parameters* required
close_source_branchbooleanIf true, automatically closes the source branch upon pull request merge.default: false
descriptionstringDetailed Markdown description of the pull request, outlining changes and purpose.
destination_branchstringName of the destination branch for merging; defaults to repository's main branch if unspecified.
repo_slugstringSlug (URL-friendly name) of the repository for the pull request.
reviewersarrayList of Bitbucket user UUIDs to be added as reviewers.
source_branchstringName of the source branch with changes to be merged.
titlestringConcise title summarizing the changes for the pull request.
workspacestringWorkspace ID (UUID or slug) of the repository owner.
BITBUCKET_CREATE_REPOSITORYCreates a new Bitbucket 'git' repository in a specified workspace, defaulting to the workspace's oldest project if `project_key` is not provided.9 params
Creates a new Bitbucket 'git' repository in a specified workspace, defaulting to the workspace's oldest project if `project_key` is not provided.
Parameters* required
descriptionstringDescription for the new repository.
fork_policystringForking policy for the repository, determining who can create forks.one of
allow_forks · no_public_forks · no_forksdefault: allow_forkshas_issuesbooleanEnable the issue tracker (`True`), or disable it (`False`).default: true
has_wikibooleanEnable the wiki (`True`), or disable it (`False`).default: true
is_privatebooleanRepository visibility: `True` for private, `False` for public.default: true
languagestringPrimary programming language (e.g., 'python', 'java') for categorization.
project_keystringKey of the Bitbucket project for the repository; if omitted, it's placed in the workspace's oldest project.
repo_slugstringURL-friendly slug for the new repository.
workspacestringID or slug of the Bitbucket workspace for the new repository.
BITBUCKET_CREATE_SNIPPET_COMMENTPosts a new top-level comment or a threaded reply to an existing comment on a specified Bitbucket snippet.4 params
Posts a new top-level comment or a threaded reply to an existing comment on a specified Bitbucket snippet.
Parameters* required
contentstringRaw text content of the comment; Bitbucket will render any included markup (like Markdown).
encoded_idstringUnique, encoded ID of the Bitbucket snippet to comment on (typically part of the snippet's URL).
parent_idintegerID of an existing comment to reply to, creating a threaded comment; if omitted, a top-level comment is created.
workspacestringWorkspace ID or slug (e.g., 'my_workspace_slug' or a UUID) for the Bitbucket workspace containing the snippet.
BITBUCKET_DELETE_ISSUEPermanently deletes a specific issue, identified by its `issue_id`, from the repository specified by `repo_slug` within the given `workspace`.3 params
Permanently deletes a specific issue, identified by its `issue_id`, from the repository specified by `repo_slug` within the given `workspace`.
Parameters* required
issue_idstringThe unique identifier of the issue to be deleted from the specified repository.
repo_slugstringThe slug of the repository. This is the repository's name, usually in lowercase and with hyphens instead of spaces.
workspacestringThe workspace ID (slug) or UUID of the Bitbucket workspace that owns the repository. This can be the workspace name or its universally unique identifier.
BITBUCKET_DELETE_REPOSITORYPermanently deletes a specified Bitbucket repository; this action is irreversible and does not affect forks.2 params
Permanently deletes a specified Bitbucket repository; this action is irreversible and does not affect forks.
Parameters* required
repo_slugstringThe slug (URL-friendly name) of the repository to be deleted. This identifies the repository within the workspace.
workspacestringThe ID or slug of the Bitbucket workspace that owns the repository. This can be a user's username or a team's slug.
BITBUCKET_GET_CURRENT_USERRetrieves the profile information (UUID, display name, links, creation date) for the currently authenticated Bitbucket user.
Retrieves the profile information (UUID, display name, links, creation date) for the currently authenticated Bitbucket user.
No parameter schema in public metadata yet.
BITBUCKET_GET_FILE_FROM_REPOSITORYRetrieves a specific file's content from a Bitbucket repository at a given commit (hash, branch, or tag), failing if the file path is invalid for that commit.4 params
Retrieves a specific file's content from a Bitbucket repository at a given commit (hash, branch, or tag), failing if the file path is invalid for that commit.
Parameters* required
commitstringCommit hash, branch name (fetches latest), or tag for the file version.
pathstringFull path to the file within the repository (e.g., 'src/main.py').
repo_slugstringRepository slug or UUID (typically URL-formatted name).
workspacestringWorkspace ID or UUID (often username or team name) containing the repository.
BITBUCKET_GET_PULL_REQUESTGet a single pull request by ID with complete details.3 params
Get a single pull request by ID with complete details.
Parameters* required
pull_request_idintegerThe ID of the pull request to retrieve.
repo_slugstringRepository slug (URL-friendly name).
workspacestringWorkspace ID or slug (URL-friendly name).
BITBUCKET_GET_SNIPPETRetrieves a specific Bitbucket snippet by its encoded ID from an existing workspace, returning its metadata and file structure.3 params
Retrieves a specific Bitbucket snippet by its encoded ID from an existing workspace, returning its metadata and file structure.
Parameters* required
accept_formatstringThe desired format for the response. Valid options are 'application/json', 'multipart/related', or 'multipart/form-data'. This may affect how snippet content or file data is presented.default: application/json
encoded_idstringThe unique identifier (encoded ID) of the snippet to be retrieved.
workspacestringThe workspace ID (slug) or the workspace UUID surrounded by curly braces, identifying the Bitbucket workspace.
BITBUCKET_LIST_PULL_REQUESTSLists pull requests in a specified, accessible Bitbucket repository, optionally filtering by state (OPEN, MERGED, DECLINED).5 params
Lists pull requests in a specified, accessible Bitbucket repository, optionally filtering by state (OPEN, MERGED, DECLINED).
Parameters* required
pageintegerPage number for paginated results (starts from 1).
pagelenintegerNumber of pull requests per page (1-100). Bitbucket default if not specified.
repo_slugstringRepository slug (URL-friendly name).
statestringLifecycle state of a pull request.one of
OPEN · MERGED · DECLINEDworkspacestringWorkspace ID or slug (URL-friendly name).
BITBUCKET_LIST_REPOSITORIES_IN_WORKSPACELists repositories in a specified Bitbucket workspace, accessible to the authenticated user, with options to filter by role or query string, and sort results.4 params
Lists repositories in a specified Bitbucket workspace, accessible to the authenticated user, with options to filter by role or query string, and sort results.
Parameters* required
qstringQuery string using Bitbucket's REST API filtering syntax to filter repositories. For detailed syntax, refer to Bitbucket API documentation.
rolestringFilters repositories by the authenticated user's role within each repository.
sortstringField for sorting repository results. Prefix with '-' for descending order. Common sortable fields: 'name', 'updated_on', 'created_on'.
workspacestringThe identifier of the Bitbucket workspace. This can be the workspace slug (e.g., 'my-workspace') or its UUID enclosed in curly braces (e.g., '{workspace-uuid}').
BITBUCKET_LIST_WORKSPACE_MEMBERSLists all members of a specified Bitbucket workspace; the workspace must exist.1 params
Lists all members of a specified Bitbucket workspace; the workspace must exist.
Parameters* required
workspacestringThe workspace ID (UUID) or slug from which to list members. The slug is the user-friendly, URL-safe identifier for the workspace.
BITBUCKET_LIST_WORKSPACESLists Bitbucket workspaces accessible to the authenticated user, optionally filtered and sorted.2 params
Lists Bitbucket workspaces accessible to the authenticated user, optionally filtered and sorted.
Parameters* required
qstringQuery string to filter workspaces by attributes, following Bitbucket's filtering syntax.
sortstringField to sort returned workspaces by; prefix with a hyphen (-) for descending order.
BITBUCKET_UPDATE_ISSUEUpdates an existing issue in a Bitbucket repository by modifying specified attributes; requires `workspace`, `repo_slug`, `issue_id`, and at least one attribute to update.12 params
Updates an existing issue in a Bitbucket repository by modifying specified attributes; requires `workspace`, `repo_slug`, `issue_id`, and at least one attribute to update.
Parameters* required
assignee_account_idstringThe Bitbucket account ID (UUID) of the user to assign the issue to. If omitted, the assignee remains unchanged.
componentstringThe name of the component to associate with the issue (e.g., 'API', 'Frontend'). If omitted, the component remains unchanged.
contentstringThe new content or description for the issue, in raw text format. If omitted, the content remains unchanged.
issue_idstringThe unique identifier (ID) of the issue to be updated.
kindstringThe updated kind (type) for the issue. If omitted, kind remains unchanged.
milestonestringThe name of the milestone to associate with the issue (e.g., 'Sprint 1', 'v1.0 Launch'). If omitted, the milestone remains unchanged.
prioritystringThe updated priority for the issue. If omitted, priority remains unchanged.
repo_slugstringThe slug or name of the repository (e.g., 'my-app-repo').
statestringThe updated state for the issue. If omitted, state remains unchanged.
titlestringThe new title for the issue. If omitted, the title remains unchanged.
versionstringThe name of the version affected by this issue (e.g., '1.0.0', '2.0-beta'). If omitted, the version remains unchanged.
workspacestringThe workspace ID or slug that owns the repository (e.g., 'my-company' or '{123e4567-e89b-12d3-a456-426614174000}').
Featured
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
