Bitbucket

List commits in a repository. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - revision: Branch name, tag, or commit hash to start from - include: Include commits reachable from this ref - exclude: Exclude commits reachable from this ref - pagelen: Number of items per page (1-100, default: 20) - page: Page number (1-based) - format: Response format ('json' or 'markdown') Returns: List of commits with hash, message, author, and date.

Get details for a specific commit. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - commit_hash: The commit hash (full or abbreviated) - format: Response format ('json' or 'markdown') Returns: Commit details including hash, message, author, date, and parents.

List build statuses for a commit. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - commit_hash: The commit hash - pagelen: Number of items per page (1-100, default: 20) - page: Page number (1-based) - format: Response format ('json' or 'markdown') Returns: List of build statuses with state, key, name, and URL.

Create a build status for a commit. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - commit_hash: The commit hash - state: Status state ('SUCCESSFUL', 'FAILED', 'INPROGRESS', 'STOPPED') - key: Unique key for this status - url: URL to the build/CI system - name: Display name for the status - description: Status description Returns: The created commit status.

Get the diff between two commits or a commit and its parent. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - spec: Diff specification (e.g., 'commit1..commit2' or just 'commit') Returns: The unified diff as text.

List deployments in a repository. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - pagelen: Number of items per page (1-100, default: 20) - page: Page number (1-based) - format: Response format ('json' or 'markdown') Returns: List of deployments with state, environment, and release information.

Get details for a specific deployment. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - deployment_uuid: The deployment UUID - format: Response format ('json' or 'markdown') Returns: Deployment details including state, environment, release, and pipeline information.

List deployment environments in a repository. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - pagelen: Number of items per page (1-100, default: 20) - page: Page number (1-based) - format: Response format ('json' or 'markdown') Returns: List of deployment environments with name, type, and configuration.

Get details for a specific deployment environment. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - environment_uuid: The environment UUID - format: Response format ('json' or 'markdown') Returns: Environment details including name, type, restrictions, and lock status.

List downloadable files/artifacts for a repository. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - pagelen: Number of items per page (1-100, default: 20) - page: Page number (1-based) - format: Response format ('json' or 'markdown') Returns: List of downloads with name, size, and download count.

Delete a downloadable file/artifact. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - filename: The filename to delete Returns: Confirmation of deletion.

Get the content of a file from the repository. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - path: Path to the file (e.g., 'src/index.ts') - ref: Branch, tag, or commit hash (optional, defaults to main branch) Returns: The file content as text.

List the contents of a directory in the repository. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - path: Directory path (e.g., 'src' or '' for root) - ref: Branch, tag, or commit hash (optional, defaults to main branch) - pagelen: Number of items per page (1-100, default: 20) - page: Page number (1-based) - format: Response format ('json' or 'markdown') Returns: List of files and directories with path, type, and size.

List issues in a repository. Note: Issues must be enabled on the repository. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - pagelen: Number of items per page (1-100, default: 20) - page: Page number (1-based) - q: Query filter (e.g., 'state="open"', 'priority="critical"') - sort: Sort field (e.g., '-created_on' for newest first) - format: Response format ('json' or 'markdown') Returns: List of issues with id, title, state, priority, kind, and assignee.

Get details for a specific issue. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - issue_id: The issue ID - format: Response format ('json' or 'markdown') Returns: Issue details including title, content, state, priority, kind, assignee, and more.

Create a new issue in a repository. Note: Issues must be enabled on the repository. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - title: Issue title - content: Issue content/description (supports markdown) - kind: Issue kind ('bug', 'enhancement', 'proposal', 'task') - priority: Issue priority ('trivial', 'minor', 'major', 'critical', 'blocker') - assignee_uuid: UUID of the assignee (optional) - component: Component name (optional) - milestone: Milestone name (optional) - version: Version name (optional) Returns: The created issue.

Update an existing issue. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - issue_id: The issue ID - title: New title - content: New content - state: New state ('new', 'open', 'resolved', 'on hold', 'invalid', 'duplicate', 'wontfix', 'closed') - kind: New kind - priority: New priority - assignee_uuid: New assignee UUID (or null to unassign) Returns: The updated issue.

Delete an issue. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - issue_id: The issue ID Returns: Confirmation of deletion.

List comments on an issue. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - issue_id: The issue ID - pagelen: Number of items per page (1-100, default: 20) - page: Page number (1-based) - format: Response format ('json' or 'markdown') Returns: List of comments with id, content, author, and timestamps.

Add a comment to an issue. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - issue_id: The issue ID - content: Comment content (supports markdown) Returns: The created comment.

List pipelines in a repository. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - pagelen: Number of items per page (1-100, default: 20) - page: Page number (1-based) - sort: Sort field (e.g., '-created_on' for newest first) - format: Response format ('json' or 'markdown') Returns: List of pipelines with build number, state, target, duration, and timestamps.

Get details for a specific pipeline. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - pipeline_uuid: The pipeline UUID - format: Response format ('json' or 'markdown') Returns: Pipeline details including state, target, trigger, duration, and timestamps.

Trigger a new pipeline run. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - target_type: Target type ('branch', 'tag', or 'commit') - target_name: Branch name, tag name, or commit hash - selector_type: Optional selector type ('custom', 'branches', 'tags', 'pull-requests') - selector_pattern: Optional selector pattern for custom pipelines Returns: The triggered pipeline.

Stop a running pipeline. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - pipeline_uuid: The pipeline UUID Returns: Confirmation that the pipeline was stopped.

List steps for a pipeline. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - pipeline_uuid: The pipeline UUID - pagelen: Number of items per page (1-100, default: 20) - page: Page number (1-based) - format: Response format ('json' or 'markdown') Returns: List of pipeline steps with name, state, duration, and timestamps.

Get the log output for a pipeline step. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - pipeline_uuid: The pipeline UUID - step_uuid: The step UUID Returns: The log output as text.

List pipeline variables for a repository. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - pagelen: Number of items per page (1-100, default: 20) - page: Page number (1-based) - format: Response format ('json' or 'markdown') Returns: List of pipeline variables with key, value (if not secured), and secured flag.

Create a new tag in a repository. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - name: The new tag name - target: The commit hash to tag - message: Optional tag message (for annotated tags) Returns: The created tag.

Create a pipeline variable for a repository. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - key: Variable key/name - value: Variable value - secured: Whether the variable is secured (hidden in logs) Returns: The created pipeline variable.

Delete a pipeline variable. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - variable_uuid: The variable UUID Returns: Confirmation of deletion.

List pull requests in a repository. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - state: Filter by state ('OPEN', 'MERGED', 'DECLINED', 'SUPERSEDED'). Can specify multiple by repeating. - pagelen: Number of items per page (1-100, default: 20) - page: Page number (1-based) - q: Query filter - sort: Sort field (e.g., '-created_on' for newest first) - format: Response format ('json' or 'markdown') Returns: List of pull requests with id, title, state, author, and branches.

Get details for a specific pull request. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - pr_id: The pull request ID - format: Response format ('json' or 'markdown') Returns: Pull request details including title, description, state, branches, reviewers, and more.

Create a new pull request. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - title: Pull request title - source_branch: Source branch name - destination_branch: Destination branch name (optional, defaults to main branch) - description: Pull request description - close_source_branch: Close source branch after merge (default: false) - reviewers: Array of reviewer UUIDs Returns: The created pull request.

Update an existing pull request. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - pr_id: The pull request ID - title: New title - description: New description - destination_branch: New destination branch - reviewers: New list of reviewer UUIDs Returns: The updated pull request.

Approve a pull request. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - pr_id: The pull request ID Returns: Confirmation of approval.

Remove approval from a pull request. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - pr_id: The pull request ID Returns: Confirmation of unapproval.

Decline a pull request. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - pr_id: The pull request ID Returns: The declined pull request.

Delete a tag from a repository. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - tag_name: The tag name to delete Returns: Confirmation of deletion.

Merge a pull request. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - pr_id: The pull request ID - message: Merge commit message - close_source_branch: Close source branch after merge - merge_strategy: Merge strategy ('merge_commit', 'squash', 'fast_forward') Returns: The merged pull request.

List comments on a pull request. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - pr_id: The pull request ID - pagelen: Number of items per page (1-100, default: 20) - page: Page number (1-based) - format: Response format ('json' or 'markdown') Returns: List of comments with id, content, author, and timestamps.

Add a comment to a pull request. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - pr_id: The pull request ID - content: Comment content (supports markdown) Returns: The created comment.

Get the diff for a pull request. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - pr_id: The pull request ID Returns: The unified diff as text.

List branches in a repository. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - pagelen: Number of items per page (1-100, default: 20) - page: Page number (1-based) - q: Query filter (e.g., 'name ~ "feature"') - sort: Sort field (e.g., '-target.date' for newest first) - format: Response format ('json' or 'markdown') Returns: List of branches with name and target commit.

Get details for a specific branch. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - branch_name: The branch name - format: Response format ('json' or 'markdown') Returns: Branch details including name, target commit, and merge strategies.

Create a new branch in a repository. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - name: The new branch name - target: The commit hash or branch name to create from Returns: The created branch.

Delete a branch from a repository. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - branch_name: The branch name to delete Returns: Confirmation of deletion.

List tags in a repository. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - pagelen: Number of items per page (1-100, default: 20) - page: Page number (1-based) - q: Query filter - sort: Sort field - format: Response format ('json' or 'markdown') Returns: List of tags with name, target commit, and message.

Get details for a specific tag. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - tag_name: The tag name - format: Response format ('json' or 'markdown') Returns: Tag details including name, target commit, message, and tagger.

Get the branching model configuration for a repository. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - format: Response format ('json' or 'markdown') Returns: Branching model configuration including development and production branches, and branch types.

Get details for a specific branch restriction. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - restriction_id: The restriction ID - format: Response format ('json' or 'markdown') Returns: Branch restriction details including kind, pattern, and users/groups.

List repositories in a workspace. Returns a paginated list of repositories. Can filter by role (member, contributor, admin, owner). Args: - workspace: The workspace slug or UUID - pagelen: Number of items per page (1-100, default: 20) - page: Page number (1-based) - q: Query filter (e.g., 'name ~ "test"') - sort: Sort field (e.g., '-updated_on' for newest first) - format: Response format ('json' or 'markdown') Returns: List of repositories with name, full_name, privacy status, and more.

Get details for a specific repository. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - format: Response format ('json' or 'markdown') Returns: Repository details including name, description, size, language, main branch, etc.

Create a new repository in a workspace. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug (URL-friendly name) - name: Display name (optional, defaults to repo_slug) - description: Repository description - is_private: Whether the repository is private (default: true) - has_issues: Enable issue tracker (default: false) - has_wiki: Enable wiki (default: false) - language: Programming language - fork_policy: Fork policy ('allow_forks', 'no_public_forks', 'no_forks') - project_key: Project key to assign the repository to Returns: The created repository.

Update an existing repository. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - description: New description - is_private: Change privacy setting - has_issues: Enable/disable issue tracker - has_wiki: Enable/disable wiki - language: Update programming language - fork_policy: Update fork policy Returns: The updated repository.

Delete a repository. This action is IRREVERSIBLE. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug Returns: Confirmation of deletion.

List forks of a repository. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - pagelen: Number of items per page (1-100, default: 20) - page: Page number (1-based) - format: Response format ('json' or 'markdown') Returns: List of forked repositories.

Fork a repository to a target workspace. Args: - workspace: The source workspace slug or UUID - repo_slug: The source repository slug - target_workspace: The workspace to fork into - name: Optional name for the forked repository Returns: The forked repository.

List branch restrictions for a repository. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - pagelen: Number of items per page (1-100, default: 20) - page: Page number (1-based) - format: Response format ('json' or 'markdown') Returns: List of branch restrictions with kind, pattern, and users/groups.

Create a branch restriction for a repository. Restriction kinds: - push - Restrict pushes - force - Restrict force pushes - delete - Restrict branch deletion - restrict_merges - Restrict merges - require_tasks_to_be_completed - Require all tasks completed before merge - require_passing_builds_to_merge - Require passing builds before merge - require_approvals_to_merge - Require approvals before merge - require_default_reviewer_approvals_to_merge - Require default reviewer approvals - reset_pullrequest_approvals_on_change - Reset approvals on push - require_no_changes_requested - Require no changes requested Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - kind: Restriction kind - branch_match_kind: How to match branches ('branching_model', 'glob', 'regex') - pattern: Branch pattern (for glob/regex) - branch_type: Branch type (for branching_model: 'feature', 'bugfix', 'release', 'hotfix', 'development', 'production') - value: Value for numeric restrictions (e.g., minimum approvals) - users: Array of user UUIDs that can bypass the restriction - groups: Array of group slugs that can bypass the restriction Returns: The created branch restriction.

Update an existing branch restriction. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - restriction_id: The restriction ID - pattern: New branch pattern - value: New value for numeric restrictions - users: New user UUIDs that can bypass - groups: New group slugs that can bypass Returns: The updated branch restriction.

Delete a branch restriction. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - restriction_id: The restriction ID Returns: Confirmation of deletion.

List deploy keys for a repository. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - pagelen: Number of items per page (1-100, default: 20) - page: Page number (1-based) - format: Response format ('json' or 'markdown') Returns: List of deploy keys with id, label, and key information.

Get details for a specific deploy key. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - key_id: The deploy key ID - format: Response format ('json' or 'markdown') Returns: Deploy key details including key, label, and timestamps.

Create a deploy key for a repository. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - key: SSH public key - label: Key label/description Returns: The created deploy key.

Delete a deploy key. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - key_id: The deploy key ID Returns: Confirmation of deletion.

List webhooks for a repository. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - pagelen: Number of items per page (1-100, default: 20) - page: Page number (1-based) - format: Response format ('json' or 'markdown') Returns: List of webhooks with UUID, URL, active status, and events.

Get details for a specific webhook. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - webhook_uuid: The webhook UUID - format: Response format ('json' or 'markdown') Returns: Webhook details including URL, description, active status, and events.

Create a webhook for a repository. Common events: - repo:push - Repository push - repo:fork - Repository forked - repo:commit_status_created - Commit status created - repo:commit_status_updated - Commit status updated - pullrequest:created - Pull request created - pullrequest:updated - Pull request updated - pullrequest:approved - Pull request approved - pullrequest:unapproved - Pull request unapproved - pullrequest:fulfilled - Pull request merged - pullrequest:rejected - Pull request declined - pullrequest:comment_created - Comment on pull request - issue:created - Issue created - issue:updated - Issue updated - issue:comment_created - Comment on issue Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - url: Webhook URL - description: Webhook description - events: Array of events to trigger the webhook - active: Whether the webhook is active (default: true) Returns: The created webhook.

Update an existing webhook. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - webhook_uuid: The webhook UUID - url: New webhook URL - description: New description - events: New list of events - active: New active status Returns: The updated webhook.

Delete a webhook. Args: - workspace: The workspace slug or UUID - repo_slug: The repository slug - webhook_uuid: The webhook UUID Returns: Confirmation of deletion.

List all workspaces accessible by the authenticated user. Returns a paginated list of workspaces. Args: - pagelen: Number of items per page (1-100, default: 20) - page: Page number (1-based) - format: Response format ('json' or 'markdown') Returns: List of workspaces with slug, name, and UUID.

Get details for a specific workspace. Args: - workspace: The workspace slug or UUID - format: Response format ('json' or 'markdown') Returns: Workspace details including name, slug, UUID, and links.

List all members of a workspace. Args: - workspace: The workspace slug or UUID - pagelen: Number of items per page (1-100, default: 20) - page: Page number (1-based) - format: Response format ('json' or 'markdown') Returns: List of workspace members with their roles and permissions.