bb_ls_prs

Lists pull requests in a Bitbucket repository, filtering by state (OPEN, MERGED, DECLINED, SUPERSEDED) and supporting text search. Includes pagination and returns details like title, status, author, reviewers, and creation date in a Markdown list.

Instructions

Lists pull requests within a repository (repoSlug). If workspaceSlug is not provided, the system will use your default workspace. Filters by state (OPEN, MERGED, DECLINED, SUPERSEDED) and supports text search via query. Supports pagination via limit and cursor. Pagination details are included at the end of the text content. Returns a formatted Markdown list with each PR's title, status, author, reviewers, and creation date. Requires Bitbucket credentials to be configured.

Input Schema

Name	Required	Description
`cursor`	No	Pagination cursor for retrieving the next set of results. Obtained from previous response when more results are available.
`limit`	No	Maximum number of items to return (1-100). Controls the response size. Defaults to 25 if omitted.
`query`	No	Filter pull requests by title, description, or author (text search). Uses Bitbucket query syntax.
`repoSlug`	Yes	Repository slug containing the pull requests. This must be a valid repository in the specified workspace. Example: "project-api"
`state`	No	Filter pull requests by state. Options: "OPEN" (active PRs), "MERGED" (completed PRs), "DECLINED" (rejected PRs), or "SUPERSEDED" (replaced PRs). If omitted, defaults to showing all states.
`workspaceSlug`	No	Workspace slug containing the repository. If not provided, the system will use your default workspace (either configured via BITBUCKET_DEFAULT_WORKSPACE or the first workspace in your account). Example: "myteam"

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "cursor": {
      "description": "Pagination cursor for retrieving the next set of results. Obtained from previous response when more results are available.",
      "type": "string"
    },
    "limit": {
      "description": "Maximum number of items to return (1-100). Controls the response size. Defaults to 25 if omitted.",
      "exclusiveMinimum": 0,
      "maximum": 100,
      "type": "integer"
    },
    "query": {
      "description": "Filter pull requests by title, description, or author (text search). Uses Bitbucket query syntax.",
      "type": "string"
    },
    "repoSlug": {
      "description": "Repository slug containing the pull requests. This must be a valid repository in the specified workspace. Example: \"project-api\"",
      "minLength": 1,
      "type": "string"
    },
    "state": {
      "description": "Filter pull requests by state. Options: \"OPEN\" (active PRs), \"MERGED\" (completed PRs), \"DECLINED\" (rejected PRs), or \"SUPERSEDED\" (replaced PRs). If omitted, defaults to showing all states.",
      "enum": [
        "OPEN",
        "MERGED",
        "DECLINED",
        "SUPERSEDED"
      ],
      "type": "string"
    },
    "workspaceSlug": {
      "description": "Workspace slug containing the repository. If not provided, the system will use your default workspace (either configured via BITBUCKET_DEFAULT_WORKSPACE or the first workspace in your account). Example: \"myteam\"",
      "type": "string"
    }
  },
  "required": [
    "repoSlug"
  ],
  "type": "object"
}

Atlassian Bitbucket MCP Server

bb_ls_prs

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Atlassian Bitbucket MCP Server

Related Tools

MCP directory API