Bitbucket

Bitbucket MCP Server for Cloudflare Workers

Available Tools

73 tools available in the Bitbucket MCP server. Each tool can be called by AI assistants to perform specific actions.

bitbucket_list_commits

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "exclude": {
      "type": "string",
      "description": "Exclude commits reachable from this ref"
    },
    "include": {
      "type": "string",
      "description": "Include commits reachable from this ref"
    },
    "pagelen": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    },
    "revision": {
      "type": "string",
      "description": "Branch, tag, or commit to start from"
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    }
  }
}

bitbucket_get_commit

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "commit_hash"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    },
    "commit_hash": {
      "type": "string",
      "description": "Commit hash"
    }
  }
}

bitbucket_list_commit_statuses

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "commit_hash"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "pagelen": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    },
    "commit_hash": {
      "type": "string",
      "description": "Commit hash"
    }
  }
}

bitbucket_create_commit_status

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "commit_hash",
    "state",
    "key",
    "url"
  ],
  "properties": {
    "key": {
      "type": "string",
      "description": "Unique key for this status"
    },
    "url": {
      "type": "string",
      "description": "URL to the build system"
    },
    "name": {
      "type": "string",
      "description": "Display name"
    },
    "state": {
      "enum": [
        "SUCCESSFUL",
        "FAILED",
        "INPROGRESS",
        "STOPPED"
      ],
      "type": "string",
      "description": "Status state"
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    },
    "commit_hash": {
      "type": "string",
      "description": "Commit hash"
    },
    "description": {
      "type": "string",
      "description": "Status description"
    }
  }
}

bitbucket_get_diff

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "spec"
  ],
  "properties": {
    "spec": {
      "type": "string",
      "description": "Diff spec (e.g., \"commit1..commit2\" or \"commit"
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    }
  }
}

bitbucket_list_deployments

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "pagelen": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    }
  }
}

bitbucket_get_deployment

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "deployment_uuid"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    },
    "deployment_uuid": {
      "type": "string",
      "description": "Deployment UUID"
    }
  }
}

bitbucket_list_environments

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "pagelen": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    }
  }
}

bitbucket_get_environment

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "environment_uuid"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    },
    "environment_uuid": {
      "type": "string",
      "description": "Environment UUID"
    }
  }
}

bitbucket_list_downloads

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "pagelen": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    }
  }
}

bitbucket_delete_download

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "filename"
  ],
  "properties": {
    "filename": {
      "type": "string",
      "description": "Filename to delete"
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    }
  }
}

bitbucket_get_file_content

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "path"
  ],
  "properties": {
    "ref": {
      "type": "string",
      "description": "Branch, tag, or commit hash"
    },
    "path": {
      "type": "string",
      "description": "File path"
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    }
  }
}

bitbucket_list_directory

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug"
  ],
  "properties": {
    "ref": {
      "type": "string",
      "description": "Branch, tag, or commit hash"
    },
    "page": {
      "type": "integer",
      "minimum": 1
    },
    "path": {
      "type": "string",
      "default": "",
      "description": "Directory path"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "pagelen": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    }
  }
}

bitbucket_list_issues

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug"
  ],
  "properties": {
    "q": {
      "type": "string",
      "description": "Query filter"
    },
    "page": {
      "type": "integer",
      "minimum": 1
    },
    "sort": {
      "type": "string",
      "description": "Sort field"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "pagelen": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    }
  }
}

bitbucket_get_issue

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "issue_id"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "issue_id": {
      "type": "integer",
      "description": "Issue ID"
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    }
  }
}

bitbucket_create_issue

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "title"
  ],
  "properties": {
    "title": {
      "type": "string",
      "description": "Issue title"
    },
    "content": {
      "type": "string",
      "default": "bug') .describe('Issue kind'), priority: z .enum(['trivial', 'minor', 'major', 'critical', 'blocker']) .default('major') .describe('Priority",
      "description": "Issue content"
    },
    "version": {
      "type": "string",
      "description": "Version name"
    },
    "component": {
      "type": "string",
      "description": "Component name"
    },
    "milestone": {
      "type": "string",
      "description": "Milestone name"
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    },
    "assignee_uuid": {
      "type": "string",
      "description": "Assignee UUID"
    }
  }
}

bitbucket_update_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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "issue_id"
  ],
  "properties": {
    "kind": {
      "enum": [
        "bug",
        "enhancement",
        "proposal",
        "task"
      ],
      "type": "string",
      "description": "New kind"
    },
    "title": {
      "type": "string",
      "description": "New title"
    },
    "content": {
      "type": "string",
      "description": "New content"
    },
    "issue_id": {
      "type": "integer",
      "description": "Issue ID"
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    },
    "assignee_uuid": {
      "type": "string",
      "description": "New assignee UUID or null"
    }
  }
}

bitbucket_delete_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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "issue_id"
  ],
  "properties": {
    "issue_id": {
      "type": "integer",
      "description": "Issue ID"
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    }
  }
}

bitbucket_list_issue_comments

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "issue_id"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "pagelen": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    },
    "issue_id": {
      "type": "integer",
      "description": "Issue ID"
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    }
  }
}

bitbucket_create_issue_comment

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "issue_id",
    "content"
  ],
  "properties": {
    "content": {
      "type": "string",
      "description": "Comment content"
    },
    "issue_id": {
      "type": "integer",
      "description": "Issue ID"
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    }
  }
}

bitbucket_list_pipelines

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "minimum": 1
    },
    "sort": {
      "type": "string",
      "description": "Sort field"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "pagelen": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    }
  }
}

bitbucket_get_pipeline

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "pipeline_uuid"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    },
    "pipeline_uuid": {
      "type": "string",
      "description": "Pipeline UUID"
    }
  }
}

bitbucket_trigger_pipeline

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "target_type"
  ],
  "properties": {
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    },
    "target_name": {
      "type": "string",
      "description": "Branch name, tag name, or commit hash"
    },
    "target_type": {
      "enum": [
        "branch",
        "tag",
        "commit"
      ],
      "type": "string",
      "description": "Target type"
    },
    "selector_pattern": {
      "type": "string",
      "description": "Selector pattern for custom pipelines"
    }
  }
}

bitbucket_stop_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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "pipeline_uuid"
  ],
  "properties": {
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    },
    "pipeline_uuid": {
      "type": "string",
      "description": "Pipeline UUID"
    }
  }
}

bitbucket_list_pipeline_steps

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "pipeline_uuid"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "pagelen": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    },
    "pipeline_uuid": {
      "type": "string",
      "description": "Pipeline UUID"
    }
  }
}

bitbucket_get_pipeline_step_log

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "pipeline_uuid",
    "step_uuid"
  ],
  "properties": {
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "step_uuid": {
      "type": "string",
      "description": "Step UUID"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    },
    "pipeline_uuid": {
      "type": "string",
      "description": "Pipeline UUID"
    }
  }
}

bitbucket_list_pipeline_variables

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "pagelen": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    }
  }
}

bitbucket_create_tag

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "name",
    "target"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "New tag name"
    },
    "target": {
      "type": "string",
      "description": "Commit hash to tag"
    },
    "message": {
      "type": "string",
      "description": "Tag message (for annotated tags)"
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    }
  }
}

bitbucket_create_pipeline_variable

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "key",
    "value"
  ],
  "properties": {
    "key": {
      "type": "string",
      "description": "Variable key/name"
    },
    "value": {
      "type": "string",
      "description": "Variable value"
    },
    "secured": {
      "type": "boolean",
      "default": false,
      "description": "Whether the variable is secured"
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    }
  }
}

bitbucket_delete_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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "variable_uuid"
  ],
  "properties": {
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    },
    "variable_uuid": {
      "type": "string",
      "description": "Variable UUID"
    }
  }
}

bitbucket_list_pull_requests

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug"
  ],
  "properties": {
    "q": {
      "type": "string",
      "description": "Query filter"
    },
    "page": {
      "type": "integer",
      "minimum": 1
    },
    "sort": {
      "type": "string",
      "description": "Sort field"
    },
    "state": {
      "type": "string",
      "description": "Filter by state (OPEN, MERGED, DECLINED, SUPERSEDED)"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "pagelen": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    }
  }
}

bitbucket_get_pull_request

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "pr_id"
  ],
  "properties": {
    "pr_id": {
      "type": "integer",
      "description": "Pull request ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    }
  }
}

bitbucket_create_pull_request

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "title",
    "source_branch"
  ],
  "properties": {
    "title": {
      "type": "string",
      "description": "Pull request title"
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "reviewers": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of reviewer UUIDs"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    },
    "description": {
      "type": "string",
      "description": "Pull request description"
    },
    "source_branch": {
      "type": "string",
      "description": "Source branch name"
    },
    "destination_branch": {
      "type": "string",
      "description": "Destination branch name"
    },
    "close_source_branch": {
      "type": "boolean",
      "default": false,
      "description": "Close source branch after merge"
    }
  }
}

bitbucket_update_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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "pr_id"
  ],
  "properties": {
    "pr_id": {
      "type": "integer",
      "description": "Pull request ID"
    },
    "title": {
      "type": "string",
      "description": "New title"
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "reviewers": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "New reviewer UUIDs"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    },
    "description": {
      "type": "string",
      "description": "New description"
    },
    "destination_branch": {
      "type": "string",
      "description": "New destination branch"
    }
  }
}

bitbucket_approve_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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "pr_id"
  ],
  "properties": {
    "pr_id": {
      "type": "integer",
      "description": "Pull request ID"
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    }
  }
}

bitbucket_unapprove_pull_request

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "pr_id"
  ],
  "properties": {
    "pr_id": {
      "type": "integer",
      "description": "Pull request ID"
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    }
  }
}

bitbucket_decline_pull_request

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "pr_id"
  ],
  "properties": {
    "pr_id": {
      "type": "integer",
      "description": "Pull request ID"
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    }
  }
}

bitbucket_delete_tag

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "tag_name"
  ],
  "properties": {
    "tag_name": {
      "type": "string",
      "description": "Tag name to delete"
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    }
  }
}

bitbucket_merge_pull_request

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "pr_id"
  ],
  "properties": {
    "pr_id": {
      "type": "integer",
      "description": "Pull request ID"
    },
    "message": {
      "type": "string",
      "description": "Merge commit message"
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    },
    "close_source_branch": {
      "type": "boolean",
      "description": "Close source branch after merge"
    }
  }
}

bitbucket_list_pull_request_comments

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "pr_id"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "minimum": 1
    },
    "pr_id": {
      "type": "integer",
      "description": "Pull request ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "pagelen": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    }
  }
}

bitbucket_create_pull_request_comment

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "pr_id",
    "content"
  ],
  "properties": {
    "pr_id": {
      "type": "integer",
      "description": "Pull request ID"
    },
    "content": {
      "type": "string",
      "description": "Comment content"
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    }
  }
}

bitbucket_get_pull_request_diff

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "pr_id"
  ],
  "properties": {
    "pr_id": {
      "type": "integer",
      "description": "Pull request ID"
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    }
  }
}

bitbucket_list_branches

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug"
  ],
  "properties": {
    "q": {
      "type": "string",
      "description": "Query filter"
    },
    "page": {
      "type": "integer",
      "minimum": 1
    },
    "sort": {
      "type": "string",
      "description": "Sort field"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "pagelen": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    }
  }
}

bitbucket_get_branch

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "branch_name"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    },
    "branch_name": {
      "type": "string",
      "description": "Branch name"
    }
  }
}

bitbucket_create_branch

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "name",
    "target"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "New branch name"
    },
    "target": {
      "type": "string",
      "description": "Commit hash or branch name to create from"
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    }
  }
}

bitbucket_delete_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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "branch_name"
  ],
  "properties": {
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    },
    "branch_name": {
      "type": "string",
      "description": "Branch name to delete"
    }
  }
}

bitbucket_list_tags

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug"
  ],
  "properties": {
    "q": {
      "type": "string",
      "description": "Query filter"
    },
    "page": {
      "type": "integer",
      "minimum": 1
    },
    "sort": {
      "type": "string",
      "description": "Sort field"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "pagelen": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    }
  }
}

bitbucket_get_tag

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "tag_name"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "tag_name": {
      "type": "string",
      "description": "Tag name"
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    }
  }
}

bitbucket_get_branching_model

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    }
  }
}

bitbucket_get_branch_restriction

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "restriction_id"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    },
    "restriction_id": {
      "type": "integer",
      "description": "Restriction ID"
    }
  }
}

bitbucket_list_repositories

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.

{
  "type": "object",
  "required": [
    "workspace"
  ],
  "properties": {
    "q": {
      "type": "string",
      "description": "Query filter"
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "description": "Page number"
    },
    "sort": {
      "type": "string",
      "description": "Sort field"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "pagelen": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    }
  }
}

bitbucket_get_repository

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    }
  }
}

bitbucket_create_repository

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Display name"
    },
    "has_wiki": {
      "type": "boolean",
      "default": false,
      "description": "Enable wiki"
    },
    "language": {
      "type": "string",
      "description": "Programming language"
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    },
    "has_issues": {
      "type": "boolean",
      "default": false,
      "description": "Enable issue tracker"
    },
    "is_private": {
      "type": "boolean",
      "default": true,
      "description": "Private repository"
    },
    "description": {
      "type": "string",
      "description": "Repository description"
    },
    "project_key": {
      "type": "string",
      "description": "Project key"
    }
  }
}

bitbucket_update_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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug"
  ],
  "properties": {
    "has_wiki": {
      "type": "boolean",
      "description": "Enable wiki"
    },
    "language": {
      "type": "string",
      "description": "Programming language"
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    },
    "has_issues": {
      "type": "boolean",
      "description": "Enable issue tracker"
    },
    "is_private": {
      "type": "boolean",
      "description": "Private repository"
    },
    "description": {
      "type": "string",
      "description": "New description"
    }
  }
}

bitbucket_delete_repository

Delete a repository. This action is IRREVERSIBLE.

Args:

workspace: The workspace slug or UUID
repo_slug: The repository slug

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug"
  ],
  "properties": {
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    }
  }
}

bitbucket_list_forks

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "pagelen": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    }
  }
}

bitbucket_fork_repository

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "target_workspace"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Name for the fork"
    },
    "repo_slug": {
      "type": "string",
      "description": "Source repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Source workspace slug or UUID"
    },
    "target_workspace": {
      "type": "string",
      "description": "Target workspace slug"
    }
  }
}

bitbucket_list_branch_restrictions

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "pagelen": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    }
  }
}

bitbucket_create_branch_restriction

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "kind"
  ],
  "properties": {
    "kind": {
      "type": "string",
      "description": "Restriction kind"
    },
    "users": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "User UUIDs that can bypass"
    },
    "value": {
      "type": "number",
      "description": "Value for numeric restrictions"
    },
    "groups": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Group slugs that can bypass"
    },
    "pattern": {
      "type": "string",
      "description": "Branch pattern (for glob/regex)"
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    },
    "branch_type": {
      "type": "string",
      "description": "Branch type (for branching_model)"
    }
  }
}

bitbucket_update_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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "restriction_id"
  ],
  "properties": {
    "users": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "New user UUIDs"
    },
    "value": {
      "type": "number",
      "description": "New value"
    },
    "groups": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "New group slugs"
    },
    "pattern": {
      "type": "string",
      "description": "New branch pattern"
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    },
    "restriction_id": {
      "type": "integer",
      "description": "Restriction ID"
    }
  }
}

bitbucket_delete_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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "restriction_id"
  ],
  "properties": {
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    },
    "restriction_id": {
      "type": "integer",
      "description": "Restriction ID"
    }
  }
}

bitbucket_list_deploy_keys

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "pagelen": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    }
  }
}

bitbucket_get_deploy_key

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "key_id"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "key_id": {
      "type": "integer",
      "description": "Deploy key ID"
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    }
  }
}

bitbucket_create_deploy_key

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "key",
    "label"
  ],
  "properties": {
    "key": {
      "type": "string",
      "description": "SSH public key"
    },
    "label": {
      "type": "string",
      "description": "Key label"
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    }
  }
}

bitbucket_delete_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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "key_id"
  ],
  "properties": {
    "key_id": {
      "type": "integer",
      "description": "Deploy key ID"
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    }
  }
}

bitbucket_list_webhooks

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "pagelen": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    }
  }
}

bitbucket_get_webhook

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "webhook_uuid"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    },
    "webhook_uuid": {
      "type": "string",
      "description": "Webhook UUID"
    }
  }
}

bitbucket_create_webhook

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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "url",
    "events"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "Webhook URL"
    },
    "active": {
      "type": "boolean",
      "default": true,
      "description": "Whether the webhook is active"
    },
    "events": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Events to trigger the webhook"
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    },
    "description": {
      "type": "string",
      "description": "Webhook description"
    }
  }
}

bitbucket_update_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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "webhook_uuid"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "New webhook URL"
    },
    "active": {
      "type": "boolean",
      "description": "New active status"
    },
    "events": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "New events"
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    },
    "description": {
      "type": "string",
      "description": "New description"
    },
    "webhook_uuid": {
      "type": "string",
      "description": "Webhook UUID"
    }
  }
}

bitbucket_delete_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.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "webhook_uuid"
  ],
  "properties": {
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    },
    "webhook_uuid": {
      "type": "string",
      "description": "Webhook UUID"
    }
  }
}

bitbucket_list_workspaces

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.

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "minimum": 1,
      "description": "Page number"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "pagelen": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page"
    }
  }
}

bitbucket_get_workspace

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.

{
  "type": "object",
  "required": [
    "workspace"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    }
  }
}

bitbucket_list_workspace_members

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.

{
  "type": "object",
  "required": [
    "workspace"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "minimum": 1,
      "description": "Page number"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "pagelen": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page"
    },
    "workspace": {
      "type": "string",
      "description": "Workspace slug or UUID"
    }
  }
}