> ## Documentation Index
> Fetch the complete documentation index at: https://veryfront.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Bitbucket

> Manage repositories, pull requests, and issues on Bitbucket

## At a glance

* **Availability**: Experimental ([how to enable](/cloud/integrations)).
* **Auth**: OAuth 2.0.
* **Connection**: A user authorizes the connection in the provider's consent screen.
* **Scopes**: `repository`, `pullrequest:write`, `issue`, `account`.

## Credentials

Set these per environment. See [Connect an integration](/cloud/integrations).

With a managed OAuth app, Connect works without these variables; set them to use your own OAuth app instead.

| Variable                  | Required | Description                                                                                                               |
| ------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------- |
| `BITBUCKET_CLIENT_ID`     | Yes      | Bitbucket OAuth Consumer Key [Docs](https://support.atlassian.com/bitbucket-cloud/docs/use-oauth-on-bitbucket-cloud/).    |
| `BITBUCKET_CLIENT_SECRET` | Yes      | Bitbucket OAuth Consumer Secret [Docs](https://support.atlassian.com/bitbucket-cloud/docs/use-oauth-on-bitbucket-cloud/). |

## Tools

| Tool                     | Access | Description                            |
| ------------------------ | ------ | -------------------------------------- |
| List Repositories        | Read   | Get list of user's repositories        |
| Get Repository           | Read   | Get details of a specific repository   |
| List Pull Requests       | Read   | Get pull requests for a repository     |
| Get Pull Request         | Read   | Get details of a specific pull request |
| Create Pull Request      | Write  | Create a new pull request              |
| Add Pull Request Comment | Write  | Add a comment to a pull request        |
| List Issues              | Read   | Get issues for a repository            |

## Example prompts

* Show me my open pull requests on Bitbucket and help me review them. Summarize the changes and any comments.
* Show me all my Bitbucket repositories with their details and recent activity.
* Show me the open issues in my repositories and help me prioritize them.