# Bitbucket MCP > Bitbucket connects your Git repositories directly into any AI agent, letting you manage complex software development workflows through natural conversation. List pull requests, check commit history, and monitor CI/CD pipelines without leaving your chat window. ## Overview - **Category:** ship-it - **Price:** Free - **Tags:** git, version-control, pull-requests, ci-cd, repository-management, code-review ## Description Use this MCP to connect your Bitbucket Cloud account and run entire software development processes using just plain language. Instead of jumping between Git interfaces or running multiple commands in a terminal, you can simply ask your agent for updates. You can list all repositories across your workspaces, check the status of pull requests, and even review commit activity history. It also tracks the health of your CI/CD pipelines. Because this MCP is hosted on Vinkius, you connect once from any compatible client—like Cursor or Claude—and gain access to Bitbucket alongside thousands of other services. You just talk to it and get actionable data back. ## Tools ### get_pull_request Retrieves specific details about one pull request by its ID. ### list_commits Generates a list of commits made to a selected repository. ### get_repository Provides full metadata for a specific project repository. ### get_user_profile Pulls the profile information of the currently authenticated user. ### list_branches Lists all available branches for a given repository. ### list_issues Retrieves open issues for a repository, provided the issue tracker is enabled. ### list_pipelines Lists all CI/CD pipelines associated with a specific repository. ### list_pull_requests Gets a list of all pull requests within a given repository. ### list_repositories Lists every repository available in the connected workspace. ### list_workspaces Retrieves a list of all accessible team workspaces. ## Prompt Examples **Prompt:** ``` List all pull requests in repository 'my-app' within workspace 'my-team'. ``` **Response:** ``` I've retrieved the pull requests for 'my-app'. There are 2 open PRs: 'Feature: New Auth' (ID: 12) and 'Fix: Memory Leak' (ID: 15). ``` **Prompt:** ``` Check the status of the last pipeline run for 'my-app'. ``` **Response:** ``` The latest pipeline for 'my-app' (Build #452) completed successfully in 3 minutes and 12 seconds. ``` **Prompt:** ``` List the last 5 commits in repository 'my-app'. ``` **Response:** ``` Retrieving commits... The last 5 commits include updates to the README, a bugfix for the API client, and new tests for the auth module. ``` ## Capabilities ### List all repositories Retrieve a list of every repository available in your workspaces. ### Check pull request status Get details and monitor the current state of any specific pull request. ### Track commit history View a list of commits made to a repository, including who wrote them and when. ### Monitor pipelines Check the status of CI/CD builds (Bitbucket Pipelines) for success or failure. ### Discover branches and issues List all active branches or check for open issues within a project's tracker. ## Use Cases ### Need to know if a feature branch is ready for merge? A developer asks their agent: 'What are the open pull requests and have they passed CI/CD?' The agent runs list_pull_requests, then checks list_pipelines. It reports that PR #12 is green on all builds and has 3 approvals. They can proceed with confidence. ### Debugging a build failure quickly. A DevOps engineer asks: 'Show me the last five commits for 'user-service' and what the status of the latest pipeline was.' The agent uses list_commits and list_pipelines, showing the commit that introduced the error right next to the failed build report. ### Preparing for a team sync. A team lead asks: 'List all repositories in our main workspace and show me any open issues for the billing module.' The agent uses list_repositories, then runs list_issues on the target repo. They get an immediate status report. ### Onboarding a new developer. A manager asks: 'What are the core services we maintain?' The agent calls list_workspaces and list_repositories, giving the new hire a comprehensive map of the codebase structure immediately. ## Benefits - Instantly check pull request statuses. Instead of clicking through multiple tabs to see if a merge is blocked, your agent gets you the status directly. - Monitor CI/CD pipelines effortlessly. You get immediate feedback on whether a build succeeded or failed using list_pipelines without logging into the Jenkins dashboard. - Never lose track of code history again. Use list_commits to quickly find out who made what change and when, giving perfect context for discussions. - Manage teams with confidence. By listing repositories and workspaces, you get a clean overview of everything your team is working on. - Streamline reviews. You can check details about specific pull requests using get_pull_request in one go, speeding up the entire code review cycle. ## How It Works The bottom line is you manage complex code workflows using conversation, not command lines. 1. Subscribe to this MCP and provide your Bitbucket username and App Password. 2. Direct your AI agent to the connection. You don't need to remember specific commands or API endpoints. 3. Ask a plain language question, like 'What is the status of PR #45?' and get the answer instantly. ## Frequently Asked Questions **How do I check the status of a pull request using Bitbucket MCP?** You use get_pull_request by providing the ID. This tool retrieves all necessary details, letting you know if it's open, merged, or requires changes. **Does Bitbucket MCP track user accounts?** Yes, the list_user_profile tool lets your agent retrieve the authenticated user's profile information directly from Bitbucket. **Can I see all branches in a repo with this MCP?** You use list_branches to get a complete and up-to-date list of every active branch for that repository. **What is the difference between list_commits and listing repositories?** list_repositories gives you metadata about the project container itself. list_commits tracks the specific changes, including who authored them and when, within a single project. **How often is pipeline data updated in Bitbucket MCP?** The list_pipelines tool pulls real-time status from Bitbucket Pipelines, so you are always viewing the most current build health information available.