← Bitbucket Cloud MCP Server

Bitbucket Cloud MCP Server 1.1.0

npm · @lexmata/bitbucket-mcp · current release

34
Tools
0
Resources
3
Templates
0
Prompts

Observation

Observed 2026-08-22T14:11:54.330Z using mcpSecurity-inventory. Status: succeeded. Negotiated protocol: 2025-06-18.

Server capabilities
{
  "tools": {},
  "resources": {}
}

Tools 34

ToolCategoryAnnotationsRisk
add_pr_commentAdd a comment to a pull request. Can be a general comment or an inline comment on a specific file/line.
Input schema
{
  "type": "object",
  "properties": {
    "workspace": {
      "type": "string",
      "description": "The workspace slug"
    },
    "repo_slug": {
      "type": "string",
      "description": "The repository slug"
    },
    "pr_id": {
      "type": "number",
      "description": "The pull request ID"
    },
    "content": {
      "type": "string",
      "description": "Comment content (markdown)"
    },
    "path": {
      "type": "string",
      "description": "File path for inline comment"
    },
    "line": {
      "type": "number",
      "description": "Line number for inline comment"
    }
  },
  "required": [
    "workspace",
    "repo_slug",
    "pr_id",
    "content"
  ]
}
— · —
approve_pull_requestApprove a pull request.
Input schema
{
  "type": "object",
  "properties": {
    "workspace": {
      "type": "string",
      "description": "The workspace slug"
    },
    "repo_slug": {
      "type": "string",
      "description": "The repository slug"
    },
    "pr_id": {
      "type": "number",
      "description": "The pull request ID"
    }
  },
  "required": [
    "workspace",
    "repo_slug",
    "pr_id"
  ]
}
— · —
create_branchCreate a new branch from a specific commit or existing branch.
Input schema
{
  "type": "object",
  "properties": {
    "workspace": {
      "type": "string",
      "description": "The workspace slug"
    },
    "repo_slug": {
      "type": "string",
      "description": "The repository slug"
    },
    "name": {
      "type": "string",
      "description": "New branch name"
    },
    "target": {
      "type": "string",
      "description": "Target commit hash or branch name"
    }
  },
  "required": [
    "workspace",
    "repo_slug",
    "name",
    "target"
  ]
}
— · —
create_issueCreate a new issue in a repository.
Input schema
{
  "type": "object",
  "properties": {
    "workspace": {
      "type": "string",
      "description": "The workspace slug"
    },
    "repo_slug": {
      "type": "string",
      "description": "The repository slug"
    },
    "title": {
      "type": "string",
      "description": "Issue title"
    },
    "content": {
      "type": "string",
      "description": "Issue content/description"
    },
    "kind": {
      "type": "string",
      "enum": [
        "bug",
        "enhancement",
        "proposal",
        "task"
      ],
      "description": "Issue type"
    },
    "priority": {
      "type": "string",
      "enum": [
        "trivial",
        "minor",
        "major",
        "critical",
        "blocker"
      ],
      "description": "Priority level"
    },
    "assignee": {
      "type": "string",
      "description": "Assignee UUID"
    }
  },
  "required": [
    "workspace",
    "repo_slug",
    "title"
  ]
}
— · —
create_pull_requestCreate a new pull request from a source branch to a destination branch.
Input schema
{
  "type": "object",
  "properties": {
    "workspace": {
      "type": "string",
      "description": "The workspace slug"
    },
    "repo_slug": {
      "type": "string",
      "description": "The repository slug"
    },
    "title": {
      "type": "string",
      "description": "Pull request title"
    },
    "source_branch": {
      "type": "string",
      "description": "Source branch name"
    },
    "destination_branch": {
      "type": "string",
      "description": "Destination branch (defaults to main branch)"
    },
    "description": {
      "type": "string",
      "description": "Pull request description"
    },
    "close_source_branch": {
      "type": "boolean",
      "description": "Close source branch after merge"
    },
    "reviewers": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "List of reviewer UUIDs"
    }
  },
  "required": [
    "workspace",
    "repo_slug",
    "title",
    "source_branch"
  ]
}
— · —
create_repositoryCreate a new repository in the specified workspace.
Input schema
{
  "type": "object",
  "properties": {
    "workspace": {
      "type": "string",
      "description": "The workspace slug"
    },
    "repo_slug": {
      "type": "string",
      "description": "The repository slug"
    },
    "name": {
      "type": "string",
      "description": "Repository name"
    },
    "description": {
      "type": "string",
      "description": "Repository description"
    },
    "is_private": {
      "type": "boolean",
      "description": "Whether the repository is private"
    },
    "language": {
      "type": "string",
      "description": "Primary language"
    },
    "has_issues": {
      "type": "boolean",
      "description": "Enable issue tracker"
    },
    "has_wiki": {
      "type": "boolean",
      "description": "Enable wiki"
    },
    "project_key": {
      "type": "string",
      "description": "Project key to add repo to"
    }
  },
  "required": [
    "workspace",
    "repo_slug"
  ]
}
— · —
decline_pull_requestDecline/close a pull request without merging.
Input schema
{
  "type": "object",
  "properties": {
    "workspace": {
      "type": "string",
      "description": "The workspace slug"
    },
    "repo_slug": {
      "type": "string",
      "description": "The repository slug"
    },
    "pr_id": {
      "type": "number",
      "description": "The pull request ID"
    }
  },
  "required": [
    "workspace",
    "repo_slug",
    "pr_id"
  ]
}
— · —
delete_branchDelete a branch from a repository.
Input schema
{
  "type": "object",
  "properties": {
    "workspace": {
      "type": "string",
      "description": "The workspace slug"
    },
    "repo_slug": {
      "type": "string",
      "description": "The repository slug"
    },
    "branch_name": {
      "type": "string",
      "description": "The branch name to delete"
    }
  },
  "required": [
    "workspace",
    "repo_slug",
    "branch_name"
  ]
}
— · —
delete_issueDelete an issue from a repository.
Input schema
{
  "type": "object",
  "properties": {
    "workspace": {
      "type": "string",
      "description": "The workspace slug"
    },
    "repo_slug": {
      "type": "string",
      "description": "The repository slug"
    },
    "issue_id": {
      "type": "number",
      "description": "The issue ID"
    }
  },
  "required": [
    "workspace",
    "repo_slug",
    "issue_id"
  ]
}
— · —
delete_repositoryDelete a repository. This action is irreversible.
Input schema
{
  "type": "object",
  "properties": {
    "workspace": {
      "type": "string",
      "description": "The workspace slug"
    },
    "repo_slug": {
      "type": "string",
      "description": "The repository slug"
    }
  },
  "required": [
    "workspace",
    "repo_slug"
  ]
}
— · —
get_branchGet details of a specific branch including its latest commit.
Input schema
{
  "type": "object",
  "properties": {
    "workspace": {
      "type": "string",
      "description": "The workspace slug"
    },
    "repo_slug": {
      "type": "string",
      "description": "The repository slug"
    },
    "branch_name": {
      "type": "string",
      "description": "The branch name"
    }
  },
  "required": [
    "workspace",
    "repo_slug",
    "branch_name"
  ]
}
— · —
get_commitGet details of a specific commit including its message, author, and parent commits.
Input schema
{
  "type": "object",
  "properties": {
    "workspace": {
      "type": "string",
      "description": "The workspace slug"
    },
    "repo_slug": {
      "type": "string",
      "description": "The repository slug"
    },
    "commit_hash": {
      "type": "string",
      "description": "The commit hash"
    }
  },
  "required": [
    "workspace",
    "repo_slug",
    "commit_hash"
  ]
}
— · —
get_commit_diffGet the diff for a specific commit showing all changes.
Input schema
{
  "type": "object",
  "properties": {
    "workspace": {
      "type": "string",
      "description": "The workspace slug"
    },
    "repo_slug": {
      "type": "string",
      "description": "The repository slug"
    },
    "commit_hash": {
      "type": "string",
      "description": "The commit hash"
    }
  },
  "required": [
    "workspace",
    "repo_slug",
    "commit_hash"
  ]
}
— · —
get_file_contentGet the content of a file from a repository.
Input schema
{
  "type": "object",
  "properties": {
    "workspace": {
      "type": "string",
      "description": "The workspace slug"
    },
    "repo_slug": {
      "type": "string",
      "description": "The repository slug"
    },
    "path": {
      "type": "string",
      "description": "File path"
    },
    "ref": {
      "type": "string",
      "description": "Git ref (branch, tag, or commit)"
    }
  },
  "required": [
    "workspace",
    "repo_slug",
    "path"
  ]
}
— · —
get_issueGet details of a specific issue.
Input schema
{
  "type": "object",
  "properties": {
    "workspace": {
      "type": "string",
      "description": "The workspace slug"
    },
    "repo_slug": {
      "type": "string",
      "description": "The repository slug"
    },
    "issue_id": {
      "type": "number",
      "description": "The issue ID"
    }
  },
  "required": [
    "workspace",
    "repo_slug",
    "issue_id"
  ]
}
— · —
get_pipelineGet details of a specific pipeline run.
Input schema
{
  "type": "object",
  "properties": {
    "workspace": {
      "type": "string",
      "description": "The workspace slug"
    },
    "repo_slug": {
      "type": "string",
      "description": "The repository slug"
    },
    "pipeline_uuid": {
      "type": "string",
      "description": "The pipeline UUID"
    }
  },
  "required": [
    "workspace",
    "repo_slug",
    "pipeline_uuid"
  ]
}
— · —
get_pr_diffGet the diff for a pull request showing all changes.
Input schema
{
  "type": "object",
  "properties": {
    "workspace": {
      "type": "string",
      "description": "The workspace slug"
    },
    "repo_slug": {
      "type": "string",
      "description": "The repository slug"
    },
    "pr_id": {
      "type": "number",
      "description": "The pull request ID"
    }
  },
  "required": [
    "workspace",
    "repo_slug",
    "pr_id"
  ]
}
— · —
get_pull_requestGet details of a specific pull request including its source, destination, and status.
Input schema
{
  "type": "object",
  "properties": {
    "workspace": {
      "type": "string",
      "description": "The workspace slug"
    },
    "repo_slug": {
      "type": "string",
      "description": "The repository slug"
    },
    "pr_id": {
      "type": "number",
      "description": "The pull request ID"
    }
  },
  "required": [
    "workspace",
    "repo_slug",
    "pr_id"
  ]
}
— · —
get_repositoryGet details of a specific repository including its branches, pull requests, and other metadata.
Input schema
{
  "type": "object",
  "properties": {
    "workspace": {
      "type": "string",
      "description": "The workspace slug"
    },
    "repo_slug": {
      "type": "string",
      "description": "The repository slug"
    }
  },
  "required": [
    "workspace",
    "repo_slug"
  ]
}
— · —
list_branchesList all branches in a repository.
Input schema
{
  "type": "object",
  "properties": {
    "workspace": {
      "type": "string",
      "description": "The workspace slug"
    },
    "repo_slug": {
      "type": "string",
      "description": "The repository slug"
    },
    "q": {
      "type": "string",
      "description": "Query string for filtering"
    },
    "sort": {
      "type": "string",
      "description": "Sort field"
    },
    "page": {
      "type": "number",
      "description": "Page number"
    },
    "pagelen": {
      "type": "number",
      "description": "Results per page"
    }
  },
  "required": [
    "workspace",
    "repo_slug"
  ]
}
— · —
list_commitsList commits in a repository with optional filtering by branch.
Input schema
{
  "type": "object",
  "properties": {
    "workspace": {
      "type": "string",
      "description": "The workspace slug"
    },
    "repo_slug": {
      "type": "string",
      "description": "The repository slug"
    },
    "branch": {
      "type": "string",
      "description": "Branch name to filter commits"
    },
    "include": {
      "type": "string",
      "description": "Commit to include"
    },
    "exclude": {
      "type": "string",
      "description": "Commit to exclude"
    },
    "page": {
      "type": "number",
      "description": "Page number"
    },
    "pagelen": {
      "type": "number",
      "description": "Results per page"
    }
  },
  "required": [
    "workspace",
    "repo_slug"
  ]
}
— · —
list_issuesList issues in a repository with optional filtering.
Input schema
{
  "type": "object",
  "properties": {
    "workspace": {
      "type": "string",
      "description": "The workspace slug"
    },
    "repo_slug": {
      "type": "string",
      "description": "The repository slug"
    },
    "q": {
      "type": "string",
      "description": "Query string for filtering"
    },
    "sort": {
      "type": "string",
      "description": "Sort field"
    },
    "page": {
      "type": "number",
      "description": "Page number"
    },
    "pagelen": {
      "type": "number",
      "description": "Results per page"
    }
  },
  "required": [
    "workspace",
    "repo_slug"
  ]
}
— · —
list_pipelinesList pipeline runs for a repository.
Input schema
{
  "type": "object",
  "properties": {
    "workspace": {
      "type": "string",
      "description": "The workspace slug"
    },
    "repo_slug": {
      "type": "string",
      "description": "The repository slug"
    },
    "page": {
      "type": "number",
      "description": "Page number"
    },
    "pagelen": {
      "type": "number",
      "description": "Results per page"
    }
  },
  "required": [
    "workspace",
    "repo_slug"
  ]
}
— · —
list_pr_commentsList all comments on a pull request.
Input schema
{
  "type": "object",
  "properties": {
    "workspace": {
      "type": "string",
      "description": "The workspace slug"
    },
    "repo_slug": {
      "type": "string",
      "description": "The repository slug"
    },
    "pr_id": {
      "type": "number",
      "description": "The pull request ID"
    },
    "page": {
      "type": "number",
      "description": "Page number"
    },
    "pagelen": {
      "type": "number",
      "description": "Results per page"
    }
  },
  "required": [
    "workspace",
    "repo_slug",
    "pr_id"
  ]
}
— · —
list_pull_requestsList pull requests for a repository with optional filtering by state.
Input schema
{
  "type": "object",
  "properties": {
    "workspace": {
      "type": "string",
      "description": "The workspace slug"
    },
    "repo_slug": {
      "type": "string",
      "description": "The repository slug"
    },
    "state": {
      "type": "string",
      "enum": [
        "OPEN",
        "MERGED",
        "DECLINED",
        "SUPERSEDED"
      ],
      "description": "Filter by state"
    },
    "page": {
      "type": "number",
      "description": "Page number"
    },
    "pagelen": {
      "type": "number",
      "description": "Results per page"
    }
  },
  "required": [
    "workspace",
    "repo_slug"
  ]
}
— · —
list_repositoriesList repositories in a workspace. Returns paginated results with repository details.
Input schema
{
  "type": "object",
  "properties": {
    "workspace": {
      "type": "string",
      "description": "The workspace slug"
    },
    "role": {
      "type": "string",
      "enum": [
        "owner",
        "admin",
        "contributor",
        "member"
      ],
      "description": "Filter by role"
    },
    "q": {
      "type": "string",
      "description": "Query string for filtering"
    },
    "sort": {
      "type": "string",
      "description": "Sort field (e.g., \"-updated_on\")"
    },
    "page": {
      "type": "number",
      "description": "Page number"
    },
    "pagelen": {
      "type": "number",
      "description": "Results per page (max 100)"
    }
  },
  "required": [
    "workspace"
  ]
}
— · —
list_repository_forksList all forks of a repository.
Input schema
{
  "type": "object",
  "properties": {
    "workspace": {
      "type": "string",
      "description": "The workspace slug"
    },
    "repo_slug": {
      "type": "string",
      "description": "The repository slug"
    },
    "page": {
      "type": "number",
      "description": "Page number"
    },
    "pagelen": {
      "type": "number",
      "description": "Results per page"
    }
  },
  "required": [
    "workspace",
    "repo_slug"
  ]
}
— · —
merge_pull_requestMerge an open pull request. Supports merge commit, squash, and fast-forward strategies.
Input schema
{
  "type": "object",
  "properties": {
    "workspace": {
      "type": "string",
      "description": "The workspace slug"
    },
    "repo_slug": {
      "type": "string",
      "description": "The repository slug"
    },
    "pr_id": {
      "type": "number",
      "description": "The pull request ID"
    },
    "message": {
      "type": "string",
      "description": "Merge commit message"
    },
    "close_source_branch": {
      "type": "boolean",
      "description": "Close source branch after merge"
    },
    "merge_strategy": {
      "type": "string",
      "enum": [
        "merge_commit",
        "squash",
        "fast_forward"
      ],
      "description": "Merge strategy"
    }
  },
  "required": [
    "workspace",
    "repo_slug",
    "pr_id"
  ]
}
— · —
request_changesRequest changes on a pull request.
Input schema
{
  "type": "object",
  "properties": {
    "workspace": {
      "type": "string",
      "description": "The workspace slug"
    },
    "repo_slug": {
      "type": "string",
      "description": "The repository slug"
    },
    "pr_id": {
      "type": "number",
      "description": "The pull request ID"
    }
  },
  "required": [
    "workspace",
    "repo_slug",
    "pr_id"
  ]
}
— · —
search_codeSearch for code across all repositories in a workspace.
Input schema
{
  "type": "object",
  "properties": {
    "workspace": {
      "type": "string",
      "description": "The workspace slug"
    },
    "search_query": {
      "type": "string",
      "description": "Search query string"
    },
    "page": {
      "type": "number",
      "description": "Page number"
    },
    "pagelen": {
      "type": "number",
      "description": "Results per page"
    }
  },
  "required": [
    "workspace",
    "search_query"
  ]
}
— · —
stop_pipelineStop a running pipeline.
Input schema
{
  "type": "object",
  "properties": {
    "workspace": {
      "type": "string",
      "description": "The workspace slug"
    },
    "repo_slug": {
      "type": "string",
      "description": "The repository slug"
    },
    "pipeline_uuid": {
      "type": "string",
      "description": "The pipeline UUID"
    }
  },
  "required": [
    "workspace",
    "repo_slug",
    "pipeline_uuid"
  ]
}
— · —
trigger_pipelineTrigger a new pipeline run on a branch, tag, or bookmark.
Input schema
{
  "type": "object",
  "properties": {
    "workspace": {
      "type": "string",
      "description": "The workspace slug"
    },
    "repo_slug": {
      "type": "string",
      "description": "The repository slug"
    },
    "ref_type": {
      "type": "string",
      "enum": [
        "branch",
        "tag",
        "bookmark"
      ],
      "description": "Reference type"
    },
    "ref_name": {
      "type": "string",
      "description": "Reference name (branch/tag name)"
    },
    "variables": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string"
          },
          "value": {
            "type": "string"
          },
          "secured": {
            "type": "boolean"
          }
        },
        "required": [
          "key",
          "value"
        ]
      },
      "description": "Pipeline variables"
    }
  },
  "required": [
    "workspace",
    "repo_slug",
    "ref_type",
    "ref_name"
  ]
}
— · —
update_issueUpdate an existing issue.
Input schema
{
  "type": "object",
  "properties": {
    "workspace": {
      "type": "string",
      "description": "The workspace slug"
    },
    "repo_slug": {
      "type": "string",
      "description": "The repository slug"
    },
    "issue_id": {
      "type": "number",
      "description": "The issue ID"
    },
    "title": {
      "type": "string",
      "description": "New title"
    },
    "content": {
      "type": "string",
      "description": "New content"
    },
    "state": {
      "type": "string",
      "enum": [
        "new",
        "open",
        "resolved",
        "on hold",
        "invalid",
        "duplicate",
        "wontfix",
        "closed"
      ],
      "description": "New state"
    },
    "kind": {
      "type": "string",
      "enum": [
        "bug",
        "enhancement",
        "proposal",
        "task"
      ],
      "description": "Issue type"
    },
    "priority": {
      "type": "string",
      "enum": [
        "trivial",
        "minor",
        "major",
        "critical",
        "blocker"
      ],
      "description": "Priority level"
    },
    "assignee": {
      "type": "string",
      "description": "Assignee UUID"
    }
  },
  "required": [
    "workspace",
    "repo_slug",
    "issue_id"
  ]
}
— · —
update_pull_requestUpdate a pull request title, description, or destination branch.
Input schema
{
  "type": "object",
  "properties": {
    "workspace": {
      "type": "string",
      "description": "The workspace slug"
    },
    "repo_slug": {
      "type": "string",
      "description": "The repository slug"
    },
    "pr_id": {
      "type": "number",
      "description": "The pull request ID"
    },
    "title": {
      "type": "string",
      "description": "New title"
    },
    "description": {
      "type": "string",
      "description": "New description"
    },
    "destination_branch": {
      "type": "string",
      "description": "New destination branch"
    }
  },
  "required": [
    "workspace",
    "repo_slug",
    "pr_id"
  ]
}
— · —

Resources 0

Resource templates 3

Prompts 0

Let’s talk about MCP security.

Share your details and our security team will contact you.