Atlassian Bitbucket MCP Server

by aashari
Verified

get-pull-request

Retrieve comprehensive details about a specific Bitbucket pull request, including description, comments, diff stats, reviewers, and branch information. Use to analyze PR context, reviews, and changes after identifying the PR ID.

Instructions

Get detailed information about a specific Bitbucket pull request.

PURPOSE: Retrieves comprehensive PR data including description, comments, diff stats, reviewers, and branch information.

WHEN TO USE:

  • When you need the full description and context of a specific PR
  • When you need to see comments, reviews, or approvals
  • When you need details about the source and destination branches
  • When you need diff statistics or changed files information
  • After using list-pull-requests to identify the relevant PR ID

WHEN NOT TO USE:

  • When you don't know which PR to look for (use list-pull-requests first)
  • When you need to browse multiple PRs (use list-pull-requests instead)
  • When you only need basic PR information without comments or details
  • When you need repository information rather than PR details (use get-repository)

RETURNS: Detailed PR information including title, description, status, author, reviewers, branches, comments, and related timestamps.

EXAMPLES:

  • Get PR details: {workspace: "myteam", repoSlug: "project-api", id: 42}

ERRORS:

  • PR not found: Verify workspace, repository slugs, and PR ID
  • Permission errors: Ensure you have access to the requested PR
  • Rate limiting: Cache PR information when possible for frequently referenced PRs

Input Schema

NameRequiredDescriptionDefault
includeCommentsNoWhether to include comments in the response. When true, includes all comments on the pull request. If omitted, defaults to false.
pullRequestIdYesNumeric ID of the pull request to retrieve. Must be a valid pull request ID in the specified repository. Example: 42
repoSlugYesRepository slug containing the pull request. This must be a valid repository in the specified workspace. Example: "project-api"
workspaceYesWorkspace slug containing the repository. Must be a valid workspace slug from your Bitbucket account. Example: "myteam"

Input Schema (JSON Schema)

{ "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "includeComments": { "description": "Whether to include comments in the response. When true, includes all comments on the pull request. If omitted, defaults to false.", "type": "boolean" }, "pullRequestId": { "description": "Numeric ID of the pull request to retrieve. Must be a valid pull request ID in the specified repository. Example: 42", "exclusiveMinimum": 0, "type": "integer" }, "repoSlug": { "description": "Repository slug containing the pull request. This must be a valid repository in the specified workspace. Example: \"project-api\"", "minLength": 1, "type": "string" }, "workspace": { "description": "Workspace slug containing the repository. Must be a valid workspace slug from your Bitbucket account. Example: \"myteam\"", "minLength": 1, "type": "string" } }, "required": [ "workspace", "repoSlug", "pullRequestId" ], "type": "object" }

You must be authenticated.

Other Tools from Atlassian Bitbucket MCP Server

Related Tools

ID: d3mfwp6ce5