Bitbucket
Bitbucket is a Git-based code hosting and collaboration platform supporting private and public repositories, enabling teams to manage and review code through pull requests and integrations
Tools (110)
Approve Pull Request
Tool to approve a pull request as the authenticated user. Use when you need to formally approve changes in a pull request review process.
Inputs: repo_slug, workspace, pull_request_id
Browse repository path
Tool to retrieve content for a file path or browse directory contents at a specified revision in a Bitbucket repository. Use when you need flexible access to repository content - returns raw file data for files or paginated directory listings for directories.
Inputs: q, page, path, sort, commit, format, pagelen, max_depth, repo_slug, workspace
Create a branch
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.
Inputs: name, repo_slug, workspace, target_hash
Create an issue
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.
Inputs: kind, title, due_on, content, assignee, priority, repo_slug, workspace, version_id, component_id, milestone_id
Create an issue comment
Adds a new comment with markdown support to an existing Bitbucket issue.
Inputs: content, issue_id, repo_slug, workspace
Create a pull request
Creates a new pull request in a specified Bitbucket repository, ensuring the source branch exists and is distinct from the (optional) destination branch.
Inputs: title, repo_slug, reviewers, workspace, description, source_branch, destination_branch, close_source_branch
Create pull request comment
Creates a new comment on a Bitbucket pull request. Supports top-level comments, threaded replies, and inline code comments. Use when providing feedback on a PR, replying to existing comments, or commenting on specific code lines.
Inputs: inline, repo_slug, workspace, content_raw, pull_request_id, parent_comment_id
Create commit report annotations
Adds multiple annotations to a commit report in bulk. Use when you need to add code analysis findings (vulnerabilities, code smells, bugs) to a report attached to a specific commit.
Inputs: commit, reportId, repo_slug, workspace, annotations
List commits from revision (POST)
Tool to list commits from a revision using POST method. Identical to GET endpoint but allows sending include/exclude parameters in request body to avoid URL length limits. Use when include/exclude parameters are too long for query strings.
Inputs: page, path, exclude, include, pagelen, revision, repo_slug, workspace
Create repository
Creates a new Bitbucket 'git' repository in a specified workspace, defaulting to the workspace's oldest project if `project_key` is not provided.
Inputs: has_wiki, language, repo_slug, workspace, has_issues, is_private, description, fork_policy, project_key
Create snippet comment
Posts a new top-level comment or a threaded reply to an existing comment on a specified Bitbucket snippet.
Inputs: content, parent_id, workspace, encoded_id
Create team pipeline variable
Creates a team-level pipeline configuration variable in Bitbucket. Use when you need to add environment variables or configuration values that should be available to all pipelines within a team.
Inputs: key, value, secured, username
Create user pipeline variable
Creates a user-level pipeline variable for Bitbucket pipelines. Use when you need to create account-level configuration variables that can be used across all repositories owned by the user.
Inputs: key, value, secured, selected_user
Decline Pull Request
Decline a Bitbucket Cloud pull request via the REST API. Use this action when you need to reject a pull request that should not be merged. This action is irreversible — once declined, the pull request cannot be reopened and must be recreated if needed.
Inputs: repo_slug, workspace, pull_request_id
Delete commit comment
Permanently deletes a specific comment on a commit. Use when removing outdated, incorrect, or unwanted feedback on a commit.
Inputs: commit, repo_slug, workspace, comment_id
Delete issue
Permanently deletes a specific issue, identified by its `issue_id`, from the repository specified by `repo_slug` within the given `workspace`.
Inputs: issue_id, repo_slug, workspace
Delete pull request comment
Permanently deletes a specific pull request comment (top-level, inline, or threaded reply). Use when removing outdated, incorrect, or unwanted feedback from a pull request.
Inputs: repo_slug, workspace, comment_id, pull_request_id
Delete commit report annotation
Deletes a single annotation matching the provided ID from a commit report. Use when you need to remove a specific annotation from a code analysis report.
Inputs: commit, reportId, repo_slug, workspace, annotationId
Delete repository
Permanently deletes a specified Bitbucket repository; this action is irreversible and does not affect forks.
Inputs: repo_slug, workspace
Delete snippet watch
Stops watching a specific snippet. Use when you want to unsubscribe from notifications for a snippet.
Inputs: workspace, encoded_id
Delete user pipeline variable
Permanently deletes a user-level pipeline configuration variable identified by its UUID. Use this to remove pipeline variables that are no longer needed at the account level.
Inputs: username, variable_uuid
Get branch
Retrieves detailed information about a specific branch in a Bitbucket repository. Use when you need to get branch metadata, the commit it points to, or verify a branch exists.
Inputs: name, repo_slug, workspace
Get Commit Build Status
Get a specific build status for a commit in Bitbucket. Use when you need to check the status of a particular build/CI run for a commit.
Inputs: key, commit, repo_slug, workspace
Get Commit Changes
Tool to retrieve a page of changes made in a specified commit, showing all changed files with their change statistics (lines added/removed, status). Use when you need to enumerate files modified in a specific commit or commit range.
Inputs: page, spec, pagelen, repo_slug, workspace
Get commit comment
Retrieves a specific comment from a commit by its ID. Use when you need to fetch details of a particular commit comment including content, author, timestamps, and inline location.
Inputs: commit, repo_slug, workspace, comment_id
Get Commit Diff
Tool to retrieve the unified diff between two provided revisions or for a single commit in a Bitbucket repository. Use when you need to see the actual code changes in a commit or between two commits. Supports filtering by file path and various diff options.
Inputs: path, spec, merge, topic, binary, context, renames, repo_slug, workspace, ignore_whitespace
Get current user (v2)
Tool to retrieve complete profile information for the currently authenticated Bitbucket user. Use when you need comprehensive user details including account_id, username, nickname, and other profile fields.
Get deployment environment variables
Retrieves deployment environment level variables for a specific Bitbucket repository environment. Use when you need to view or audit environment-specific configuration variables for deployments.
Inputs: repo_slug, workspace, environment_uuid
Get file from repository
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.
Inputs: path, commit, repo_slug, workspace
Get hook events
Retrieves a paginated list of all valid webhook events for a specified entity type (repository or workspace). Use when you need to discover available webhook event types for subscription or webhook configuration.
Inputs: subject_type
Get OpenID configuration for OIDC in Pipelines
Retrieves the OpenID Connect discovery configuration for Bitbucket Pipelines OIDC. Use when integrating Bitbucket Pipelines with resource servers (AWS, GCP, Vault) using OpenID Connect authentication. Returns issuer URL, JWKS URI, and supported capabilities.
Inputs: workspace
Get Pull Request
Get a single pull request by ID with complete details.
Inputs: repo_slug, workspace, pull_request_id
Get pull request comment
Tool to retrieve a specific comment from a pull request by its ID. Use when you need to fetch details of a particular pull request comment including content, author, timestamps, and inline location.
Inputs: repo_slug, workspace, comment_id, pull_request_id
Get Pull Request Commits
Tool to retrieve commits for a specified pull request. Use when reviewing the commit history of a PR or analyzing changes included in a pull request.
Inputs: pagelen, repo_slug, workspace, pull_request_id, response_detail
Get Pull Request Diff
Tool to fetch the unified diff for a Bitbucket pull request (follows 302 redirect to repository diff). Use when reviewing code changes in a PR. Supports optional truncation for large diffs via max_chars parameter.
Inputs: max_chars, repo_slug, workspace, pull_request_id
Get Pull Request Diffstat
Tool to get the diffstat for a Bitbucket pull request, showing all changed files with their change statistics (lines added/removed, status). Use when you need to enumerate files modified in a PR.
Inputs: page, pagelen, repo_slug, workspace, pull_request_id
Get raw file content
DEPRECATED: Use BITBUCKET_GET_FILE_FROM_REPOSITORY instead. Tool to retrieve the raw content of a file from a Bitbucket repository at a specified commit, branch, or tag. Use when you need to read file contents from a specific revision.
Inputs: path, commit, repo_slug, workspace
Get Repository Branching Model
Return the branching model as applied to the repository. Use when you need to understand the repository's branch workflow configuration, including development/production branches and branch type prefixes.
Inputs: repo_slug, workspace
Get Repository Commit
Tool to retrieve detailed information about a specific commit in a Bitbucket repository. Use when you need to get complete commit details including author, message, date, parents, and related links.
Inputs: commit, repo_slug, workspace
Get commit comments
Retrieves all comments on a specific commit in a Bitbucket repository. Returns both global and inline code comments. Use when you need to view feedback, discussions, or notes left on a specific commit.
Inputs: page, commit, pagelen, repo_slug, workspace
Get commit report
Returns a single report matching the provided ID from a commit. Use when you need to retrieve details of a specific analysis report (e.g., security scan, code coverage, test results, or bug report) for a commit.
Inputs: commit, repo_slug, report_id, workspace
Get Commit Reports
Tool to get reports linked to a specific commit. Use when you need to retrieve analysis results, test reports, security scans, or code coverage data associated with a commit.
Inputs: commit, repo_slug, workspace
Get commit report annotation
Returns a single annotation matching the provided ID from a commit report. Use when you need to retrieve details of a specific code analysis finding (e.g., vulnerability, code smell, or bug) identified in a commit.
Inputs: commit, reportId, repo_slug, workspace, annotationId
Get commit statuses
Returns all build statuses (e.g., CI/CD pipeline results) for a specific commit. Use when you need to check build status, verify test results, or monitor deployment pipelines for a particular commit.
Inputs: commit, repo_slug, workspace
Get effective branching model
Retrieves the effective branching model for a Bitbucket repository, showing which branching model is currently applied (including any inheritance from project-level settings). Use when you need to understand the repository's branch workflow configuration, including development and production branches and branch type prefixes.
Inputs: repo_slug, workspace
Get Repository Environment
Retrieve detailed information about a specific deployment environment in a Bitbucket repository. Use when you need to get environment configuration, deployment settings, or check environment properties like locks and restrictions.
Inputs: repo_slug, workspace, environment_uuid
Get file commit history
Returns a paginated list of commits that modified the specified file. Use when you need to track file changes over time, find who modified a file, or determine when a file was created or last changed.
Inputs: q, page, path, commit, fields, pagelen, renames, repo_slug, workspace
Check if user voted for issue
Tool to check whether the authenticated user has voted for a specific issue in a Bitbucket repository. Use when you need to verify if the current user has already voted on an issue before attempting to vote or unvote.
Inputs: issue_id, repo_slug, workspace
Get Repositories Merge Base
Get the merge base (best common ancestor) between two commits in a Bitbucket repository. Use when you need to find the common ancestor commit between two branches or commits for comparison or merge operations.
Inputs: revspec, repo_slug, workspace
Get specific pipeline
Retrieve a specified pipeline from a Bitbucket repository. Use when you need to get detailed information about a specific pipeline execution including its status, build number, and results.
Inputs: repo_slug, workspace, pipeline_uuid
Get repository pipelines caches
Retrieves the repository pipelines caches. Use when you need to list all caches configured for Bitbucket Pipelines in a specific repository.
Inputs: repo_slug, workspace
Get repository pipeline runners
Retrieves the list of self-hosted runners configured for a repository's pipelines. Use when you need to view available runners for pipeline execution.
Inputs: repo_slug, workspace
Get repository pipeline schedules
Retrieves configured pipeline schedules for a Bitbucket repository. Use when you need to view scheduled pipeline runs and their cron patterns.
Inputs: repo_slug, workspace
Get repository SSH known hosts
Retrieves repository-level SSH known hosts configured for Bitbucket Pipelines. Use when you need to list or verify SSH known hosts that Pipelines can connect to during builds.
Inputs: repo_slug, workspace
Get repository pipeline variables
Retrieves repository-level pipeline variables for a specific Bitbucket repository. Use when you need to view or audit pipeline configuration variables that are scoped to a repository.
Inputs: q, page, sort, pagelen, repo_slug, workspace
Get pipeline steps
Retrieves all steps for a given pipeline. Use when you need to inspect the individual steps of a pipeline execution, including their state, duration, and commands.
Inputs: repo_slug, workspace, pipeline_uuid
Get pull requests activity log
Get paginated activity log for all pull requests in a repository. Returns comments, updates, approvals, and request changes. Use when you need to track pull request activity history.
Inputs: page, pagelen, repo_slug, workspace
Get pull request comments
Retrieves a paginated list of comments on a specific pull request in a Bitbucket repository. Returns global, inline, and threaded comments. Use when you need to view feedback, discussions, or reviews left on a pull request.
Inputs: page, sort, pagelen, repo_slug, workspace, pull_request_id
Get pull request statuses
Returns all build statuses (e.g., CI/CD pipeline results) for a specific pull request. Use when you need to check build status, verify test results, or monitor deployment pipelines for a pull request.
Inputs: page, pagelen, repo_slug, workspace, pull_request_id
Get repository refs
Returns the branches and tags in the repository. Use when you need to list all refs (both branches and tags) in a single API call with optional filtering by type, name pattern, or commit hash.
Inputs: q, page, sort, pagelen, repo_slug, workspace
Get tag
Retrieves detailed information about a specific tag in a Bitbucket repository. Use when you need to get tag metadata, target commit details, or verify a tag exists.
Inputs: name, repo_slug, workspace
Get repositories src
Lists the contents of the root directory on the repository's main branch without needing to specify a commit or branch. This endpoint redirects to the main branch automatically.
Inputs: format, repo_slug, workspace
Get repository watchers
Retrieves a paginated list of all the watchers on the specified repository. Use when you need to see who is watching a particular repository.
Inputs: repo_slug, workspace
Get repository
Retrieves detailed information about a specific repository in a Bitbucket workspace. Use when you need to get repository metadata, settings, or details.
Inputs: repo_slug, workspace
Get Repository Patch
Tool to retrieve the git patch content for a Bitbucket repository at a specified revision or commit range. Use when you need to review code changes, generate diffs, or analyze modifications between commits. Returns raw patch in unified diff format.
Inputs: spec, max_chars, repo_slug, workspace
Get snippet
Retrieves a specific Bitbucket snippet by its encoded ID from an existing workspace, returning its metadata and file structure.
Inputs: workspace, encoded_id, accept_format
Get snippet watch status
Checks if the current user is watching a specific snippet. Use when you need to verify watch status for a snippet.
Inputs: workspace, encoded_id
Get SSH keys for user
Retrieves a paginated list of SSH keys for a specified Bitbucket user. Use when you need to view or audit SSH keys configured for a user account.
Inputs: page, pagelen, username
Get user
Retrieves public profile information for a specific Bitbucket user by username or UUID. Use when you need to get user details like display name, avatar, creation date, and links to related resources.
Inputs: selected_user
Get user emails
Returns all the authenticated user's email addresses, both confirmed and unconfirmed. Use when you need to retrieve all email addresses associated with the current user's account.
Get user email details
Retrieves details about a specific email address for the authenticated user. Use when you need to check if an email is primary, confirmed, or verify email ownership.
Inputs: email
Get user permissions for repositories
Returns an object for each repository the caller has explicit access to, including their permission level. Use when you need to discover which repositories the authenticated user can access and their specific permissions.
Inputs: page, pagelen
Get user permissions for workspaces
Retrieves workspace memberships and permission levels for the authenticated user. Returns an object for each workspace the caller is a member of, along with their effective role (highest privilege level). Use when you need to determine which workspaces a user can access and their permission level in each.
Inputs: q, page, pagelen
Get user workspaces
Tool to retrieve all workspaces accessible to the authenticated user. Use when you need to list workspaces the current user can access, optionally filtered by workspace slug or permission level.
Inputs: q
Get workspace
Retrieves detailed information about a specific Bitbucket workspace. Use when you need to get workspace metadata, settings, or details.
Inputs: workspace
Get Workspace Pull Requests by User
Tool to get all workspace pull requests authored by a specified user. Use when you need to retrieve pull requests created by a specific user across all repositories in a workspace.
Inputs: page, state, pagelen, workspace, selected_user
Search code in workspace
Tool to search for code in the repositories of the specified workspace. Use when you need to find specific code patterns, function definitions, or text across all repositories in a workspace.
Inputs: page, fields, pagelen, workspace, search_query
List branches
Lists branches in a Bitbucket repository with optional server-side filtering by name pattern (BBQL) and sorting. Use when you need to discover available branches, search for specific branch patterns, or navigate repository branch structure.
Inputs: q, page, sort, pagelen, repo_slug, workspace
List commits
Tool to retrieve a page of commits from a Bitbucket repository. Returns commits in reverse chronological order (newest first), similar to git log. Use when you need to browse commit history, filter commits by branch/tag, or restrict to commits affecting a specific path.
Inputs: page, path, exclude, include, pagelen, repo_slug, workspace
List commits from revision
Tool to list commits starting from a specific revision in a Bitbucket repository. Commits are paginated and returned in reverse chronological order. Use when you need to retrieve commit history from a specific commit, branch, or tag.
Inputs: page, path, exclude, include, pagelen, revision, repo_slug, workspace
List commits on master
Lists commits on the master branch of a Bitbucket repository. Use when you need to retrieve the commit history for the master branch, including commit messages, authors, dates, and parent relationships.
Inputs: page, pagelen, repo_slug, workspace
List deployments
Lists deployments for a specified Bitbucket repository. Use when you need to view deployment history and status across environments.
Inputs: q, page, sort, pagelen, repo_slug, workspace
List issues in a repository
Lists issues in a Bitbucket repository with optional filtering by state, priority, kind, or assignee. Use when you need to discover issue IDs or get an overview of repository issues.
Inputs: kind, page, state, pagelen, assignee, priority, repo_slug, workspace
List pipelines
Tool to find pipelines in a Bitbucket repository. Returns pipeline metadata including state, trigger, and duration. Use when you need to browse pipeline history or check pipeline status.
Inputs: page, pagelen, repo_slug, workspace
List pull requests
Lists pull requests in a specified, accessible Bitbucket repository, optionally filtering by state (OPEN, MERGED, DECLINED).
Inputs: page, state, pagelen, repo_slug, workspace
List pull request tasks
Lists all tasks associated with a pull request in a Bitbucket repository. Use when you need to view or track tasks on a PR.
Inputs: page, pagelen, repo_slug, workspace, pull_request_id
List all public repositories
Retrieves a paginated list of all public repositories on Bitbucket. Use when you need to discover or search across public repositories, optionally filtered by role, query string, creation date, or sorted by various fields.
Inputs: q, page, role, sort, after, pagelen
List repository environments
List all deployment environments configured for a Bitbucket repository. Use when you need to view available environments for deployments, check environment configurations, or select an environment for deployment operations.
Inputs: q, page, sort, pagelen, repo_slug, workspace
List repositories in workspace
Lists repositories in a specified Bitbucket workspace, accessible to the authenticated user, with options to filter by role or query string, and sort results. Responses are paginated; iterate using the `next` field in each response until it is absent to retrieve all repositories.
Inputs: q, page, role, sort, pagelen, workspace
List repository forks
Retrieves a paginated list of all forks for a specific repository in a Bitbucket workspace. Returns repository objects for each fork with metadata like owner, creation date, and size. Use this action when you need to discover who has forked a repository or analyze fork relationships.
Inputs: page, pagelen, repo_slug, workspace
List repository paths
Lists file and directory entries under a repository path at a given revision, with optional breadth-first recursion via max_depth for repository traversal and scanning. Fails if the path points to a file rather than a directory.
Inputs: q, page, path, sort, commit, pagelen, max_depth, repo_slug, workspace
List snippets
Returns all snippets accessible to the authenticated user. Use when you need to discover or list snippets, optionally filtered by role (owner, contributor, or member).
Inputs: page, role, pagelen
List tags
Lists tags in a Bitbucket repository with optional server-side filtering by name pattern or commit hash (BBQL) and sorting. Use when you need to discover available tags, search for specific tag patterns, or find tags pointing to specific commits.
Inputs: q, page, sort, pagelen, repo_slug, workspace
List versions
Lists versions (milestones) in a Bitbucket repository's issue tracker. Use when you need to discover available versions for associating with issues, or to retrieve version IDs for use with create_issue.
Inputs: q, page, sort, pagelen, repo_slug, workspace
List workspace members
Lists all members of a specified Bitbucket workspace; the workspace must exist.
Inputs: page, pagelen, workspace
List workspace projects
Lists projects in a specified Bitbucket workspace. Use when you need to retrieve all projects belonging to a workspace.
Inputs: q, page, sort, pagelen, workspace
List workspaces
Lists Bitbucket workspaces accessible to the authenticated user, optionally filtered and sorted. Results are paginated; follow the `next` field in each response to retrieve subsequent pages until `next` is absent. When multiple workspaces are returned, verify the correct `slug` or UUID before passing to downstream tools.
Inputs: q, page, sort, pagelen
Merge Pull Request
Tool to merge a Bitbucket Cloud pull request via the REST API. Use when you need to complete a PR merge after approval and checks pass. Supports custom merge messages, merge strategies, and source branch deletion.
Inputs: message, repo_slug, workspace, merge_strategy, pull_request_id, close_source_branch
Request Pull Request Changes
Tool to request changes on a pull request as the authenticated user. Use when you need to formally request changes in a pull request review process, indicating the PR needs modifications before approval.
Inputs: repo_slug, workspace, pull_request_id
Resolve pull request comment
Tool to resolve or reopen a pull request comment thread. Use when marking a comment as addressed during review or reopening a previously resolved thread.
Inputs: action, repo_slug, workspace, comment_id, pull_request_id
Search code in team repositories
Search for code in repositories of a specified team. Matches can occur in file content or paths. Note: Teams endpoints were deprecated in Oct 2020; use workspace search endpoints for new integrations.
Inputs: page, pagelen, username, search_query
Search code in user repositories
Tool to search for code in the repositories of a specified user. Use when you need to find specific code patterns, functions, or text across all repositories owned by a user.
Inputs: page, fields, pagelen, search_query, selected_user
Stop pipeline
Signal the stop of a pipeline and all of its steps that have not completed yet. This action is irreversible — once stopped, a pipeline cannot be restarted and must be re-triggered to run again. Use this action when you need to cancel a running pipeline execution that is no longer needed or was triggered incorrectly.
Inputs: repo_slug, workspace, pipeline_uuid
Update commit insight report
Create or update an insight report for a commit. Creates a new report if it doesn't exist, or replaces the existing one if a report already exists for the given repository, commit, and report key. Note: replacing an existing report will be rejected if the authenticated user was not the creator of the specified report.
Inputs: data, link, title, commit, result, details, logo_url, reportId, reporter, repo_slug, workspace, report_type, remote_link_enabled
Update an issue
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.
Inputs: kind, state, title, content, version, issue_id, priority, component, milestone, repo_slug, workspace, assignee_account_id
Update Pull Request
Tool to update an existing pull request's editable fields (e.g., title, description, reviewers) via the Bitbucket Cloud API. Use when you need to modify a pull request without creating a new one. Only sends fields that are explicitly provided to avoid accidental overwrites.
Inputs: draft, title, repo_slug, reviewers, workspace, description, pull_request_id, close_source_branch
Update commit comment
Updates the contents of a comment on a commit. Use when you need to modify an existing comment's text on a commit.
Inputs: commit, repo_slug, workspace, comment_id, content_raw
Update commit report annotation
Creates or updates an individual annotation for a commit report. Use when you need to add or modify code analysis findings (vulnerabilities, code smells, or bugs) identified in a commit.
Inputs: line, link, path, commit, result, details, summary, severity, repo_slug, report_id, workspace, external_id, annotation_id, annotation_type
Update team pipeline variable
Updates a team-level pipeline configuration variable in Bitbucket. Use when you need to modify existing environment variables or configuration values that are available to all pipelines within a team.
Inputs: key, value, secured, username, variable_uuid
Update user pipeline variable
Updates a user-level pipeline variable for Bitbucket pipelines. Use when you need to modify account-level configuration variables such as changing the value, key name, or security status.
Inputs: key, value, secured, selected_user, variable_uuid