# Bitbucket MCP for AI Agents AI Agent Connect

> Bitbucket MCP. Connect your Bitbucket Cloud account to any AI agent to manage repositories, pull requests, and pipelines. No more tab-switching to check build statuses or review code. It lets your agent handle the heavy lifting of repository oversight and issue tracking directly from your workspace.

## Overview
- **Category:** ship-it
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_QylYowxX5SGgCnGKgb6e2H9z4AKF53xBazfzqAf7/ai-agent-connect
- **Tags:** git, version-control, pull-requests, ci-cd, repository-management, code-review

## Description

You're tired of jumping between your code editor and a dozen browser tabs just to see if a build passed or if a colleague approved your latest pull request. This Bitbucket MCP changes that by bringing your repository data directly into your AI's context. Instead of manual searching, you can just ask your agent to summarize the latest activity or find a specific commit from last week. It handles the tedious parts of repository management, like listing branches or pulling issue lists, so you can stay focused on writing code. Because Vinkius hosts this Connector, you can get it running in minutes and start using it across any of your preferred AI clients. It's about having the right information at your fingertips without the friction of constant context switching.

## Tools

### list_commits
See the history of changes for a repository. Use this to quickly find where a specific bug might have been introduced.

### get_pull_request
Get the specific details and status of a single pull request. It helps you see exactly what's happening in a specific code review.

### list_pull_requests
See all open and closed pull requests for a repo. It's the fastest way to see what's pending review.

### get_repository
Pull the metadata and details for a specific project. This gives your agent the context it needs to understand the repo.

### get_user_profile
Fetch the profile details of the authenticated user. It helps the agent know who it's working with.

### list_branches
See all the active branches in a repository. This is great for navigating complex multi-branch workflows.

### list_issues
Pull a list of all issues for a repository with trackers. Use this to see the current backlog of work.

### list_pipelines
Get the status of all CI/CD pipelines. This lets you know if your builds are green or red instantly.

### list_repositories
See every repository within your workspace. This gives you a high-level view of all your projects.

### list_workspaces
See all the workspaces you have access to. Use this to navigate between different team environments.

## Prompt Examples

**Prompt:** 
```
What's the status of the latest build for the mobile app?
```

**Response:** 
```
The latest pipeline for 'mobile-app' (Build #882) completed successfully in 4 minutes and 12 seconds.
```

**Prompt:** 
```
List all open pull requests for the 'frontend' repo.
```

**Response:** 
```
I've found 3 open pull requests for 'frontend': 

| ID | Title | Status |
|---|---|---|
| 42 | Refactor Login Flow | Open |
| 45 | Update CSS Grid | Open |
| 49 | Fix Header Alignment | Open |
```

**Prompt:** 
```
Show me the last 3 commits on the 'backend' project.
```

**Response:** 
```
Here are the recent commits for 'backend': 

* **Auth Fix**: Resolved a token expiration bug.
* **Update Docs**: Added new endpoints to the README.
* **Refactor**: Cleaned up the database connection logic.
```

## Capabilities

### View all repositories
See every project within your workspace at once.

### Fetch pull request details
Get the specific status and information for any individual pull request.

### Retrieve latest commits
Pull the recent history of changes for any given repository.

### Check CI/CD pipeline statuses
See if your builds are passing or failing without leaving your chat.

### List open issues
Get a list of all issues for a repository that has trackers enabled.

### Access user profiles
Get the profile information for the authenticated user.

## Use Cases

### Checking PR status
An engineer asks 'Are there any open PRs for the auth module?' and the agent uses list_pull_requests to give an instant summary.

### Build monitoring
A DevOps pro asks 'Did the last pipeline for the web app succeed?' and the agent uses list_pipelines to check the status.

### Commit history
A developer wants to know who touched the API last and asks the agent to use list_commits to find the recent changes.

### Workspace audit
A manager wants to see every repo they own and asks the agent to use list_repositories to get a full list of projects.

## Benefits

- Stop tab switching by using list_pull_requests to see what needs review without leaving your editor.
- Monitor build health instantly with list_pipelines to catch failed CI/CD runs the moment they happen.
- Get a clear view of the backlog by using list_issues to pull repository tasks into your chat.
- Navigate complex projects faster by using list_branches to see all active development paths.
- Speed up your standups by using list_commits to summarize recent changes for the team.
- Gain a full project overview by using list_repositories to see every repo in your workspace.

## How It Works

The bottom line is you get a direct line to your Bitbucket data without leaving your workflow.

1. Subscribe to the Bitbucket MCP on Vinkius.
2. Enter your Bitbucket Username and App Password.
3. Ask your AI client to list repos, check PRs, or monitor pipelines.

## Frequently Asked Questions

**Does the Bitbucket MCP work with private repositories?**
Yes, it connects to your Bitbucket Cloud account so it can access any repository you have permission to view.

**Can I use the Bitbucket MCP with Cursor or Windsurf?**
Yes, it works with any MCP-compatible client, including Claude, Cursor, and Windsurf.

**Do I need to install anything on my machine?**
You just need to connect your Bitbucket credentials through Vinkius and link it to your AI client.

**Can this Connector help me with my CI/CD builds?**
It allows your agent to check the status of your Bitbucket Pipelines so you can see if builds are passing or failing.

**How do I get my Bitbucket credentials?**
You'll need to create an App Password in your Bitbucket account settings to share with the Connector.

**Can it see my issues?**
It can list issues for any repository that has the issue tracker enabled in your workspace.

**Can I check the status of my latest Bitbucket Pipeline?**
Yes! Use the `list_pipelines` tool with your Workspace and Repository slug. Your agent will fetch the latest build statuses, showing if they passed or failed.

**How do I list all open pull requests for a repository?**
Simply ask the agent to `list_pull_requests` and provide the Workspace and Repository slug. It will retrieve all current PRs awaiting review.

**Does the integration allow merging code directly?**
Currently, the toolset is focused on querying and monitoring (Read-Only). You can list and inspect PRs, commits, and branches, but destructive actions like merging or deleting branches must be done through the Bitbucket UI for safety.