Bitbucket Connector for AI agents.

Q: Can I check the status of my latest Bitbucket Pipeline?

Yes! Use the listpipelines tool with your Workspace and Repository slug. Your agent will fetch the latest build statuses, showing if they passed or failed.

Q: How do I list all open pull requests for a repository?

Simply ask the agent to listpullrequests and provide the Workspace and Repository slug. It will retrieve all current PRs awaiting review.

10 live capabilities

Manage your Git repositories and CI/CD pipelines from your favorite AI client.

Live agent request Bitbucket / Connector

Waiting for input…

AI Agent

Why people use Bitbucket

Bitbucket : Automate Git Repository Oversight and PR Tracking

This Bitbucket MCP puts that data where you're already working. You can ask your agent to pull the latest PR status or list the active branches directly. You get a unified view of your work without the constant friction of browser tabs.

What Vinkius changes

You get a direct line to your Bitbucket data without leaving your workflow.

Use it from Claude, ChatGPT, Cursor or another AI client you already have.

One account · 5,900+ Connectors

Real-world use case 01

Checking PR status

An engineer asks 'Are there any open PRs for the auth module?
Real-world use case 02

Build monitoring

A DevOps pro asks 'Did the last pipeline for the web app succeed?
Real-world use case 03

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.

Complete set · 10capabilities

The complete Bitbucket capability set.

These are the exact actions your AI can choose when you ask it to work with Bitbucket.

Capability set01 / 03

01—04

4 capabilities in this set.

Part of 10 available through Bitbucket.

01 Capability
List commits
See the history of changes for a repository. Use this to quickly find where a specific bug might have been introduced.
02 Capability
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.
03 Capability
List pull requests
See all open and closed pull requests for a repo. It's the fastest way to see what's pending review.
04 Capability
Get repository
Pull the metadata and details for a specific project. This gives your agent the context it needs to understand the repo.

Capability set02 / 03

05—07

3 capabilities in this set.

Part of 10 available through Bitbucket.

05 Capability
Get user profile
Fetch the profile details of the authenticated user. It helps the agent know who it's working with.
06 Capability
List branches
See all the active branches in a repository. This is great for navigating complex multi-branch workflows.
07 Capability
List issues
Pull a list of all issues for a repository with trackers. Use this to see the current backlog of work.

Capability set03 / 03

08—10

3 capabilities in this set.

Part of 10 available through Bitbucket.

08 Capability
List pipelines
Get the status of all CI/CD pipelines. This lets you know if your builds are green or red instantly.
09 Capability
List repositories
See every repository within your workspace. This gives you a high-level view of all your projects.
10 Capability
List workspaces
See all the workspaces you have access to. Use this to navigate between different team environments.

Set up in minutes

One URL. Then ask Bitbucket to work.

Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Bitbucket from the conversation.

Choose your client

Live preview

Advanced clients IDE · CLI

Claude · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_QylYowxX5SGgCnGKgb6e2H9z4AKF53xBazfzqAf7/mcp

Step 01

Open Connectors

In Claude Web or Claude Desktop, open Settings and choose Connectors.
Step 02

Add the URL

Choose Add custom connector, name it Bitbucket, and paste the URL above.
Step 03

Turn it on in chat

Select +, open Connectors, and enable Bitbucket for the conversation.

ChatGPT · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_QylYowxX5SGgCnGKgb6e2H9z4AKF53xBazfzqAf7/mcp

Step 01

Open MCP settings

On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
Step 02

Add the URL

Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Bitbucket URL.
Step 03

Save and start

Save the connection and enable Bitbucket in your conversation. Desktop may ask you to restart once.

Cursor · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "bitbucket": {
      "url": "https://edge.vinkius.com/vk_preview_QylYowxX5SGgCnGKgb6e2H9z4AKF53xBazfzqAf7/mcp"
    }
  }
}

Step 01

Open MCP Settings

Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
Step 02

Add the server config

Paste the JSON configuration above into the mcp.json file that opens
Step 03

Save the file

Cursor will automatically detect the new Connector
Step 04

Start using Bitbucket

Open Agent mode in chat and ask: "Using Bitbucket, help me...". 10 tools available

VS Code Copilot · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "bitbucket": {
      "url": "https://edge.vinkius.com/vk_preview_QylYowxX5SGgCnGKgb6e2H9z4AKF53xBazfzqAf7/mcp"
    }
  }
}

Step 01

Create MCP config

Create a .vscode/mcp.json file in your project root
Step 02

Add the server config

Paste the JSON configuration above
Step 03

Enable Agent mode

Open GitHub Copilot Chat and switch to Agent mode using the dropdown
Step 04

Start using Bitbucket

Ask Copilot: "Using Bitbucket, help me...". 10 tools available

Windsurf · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "bitbucket": {
      "url": "https://edge.vinkius.com/vk_preview_QylYowxX5SGgCnGKgb6e2H9z4AKF53xBazfzqAf7/mcp"
    }
  }
}

Step 01

Open MCP Settings

Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
Step 02

Add the server

Paste the JSON configuration above into mcp_config.json
Step 03

Save and reload

Windsurf will detect the new server automatically
Step 04

Start using Bitbucket

Open Cascade and ask: "Using Bitbucket, help me...". 10 tools available

Cline · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "bitbucket": {
      "url": "https://edge.vinkius.com/vk_preview_QylYowxX5SGgCnGKgb6e2H9z4AKF53xBazfzqAf7/mcp"
    }
  }
}

Step 01

Open Cline MCP Settings

Click the Connectors icon in the Cline sidebar panel
Step 02

Add remote server

Click "Add Connector" and paste the configuration above
Step 03

Enable the server

Toggle the server switch to ON
Step 04

Start using Bitbucket

Ask Cline: "Using Bitbucket, help me...". 10 tools available

Claude Code · Terminal command

Official guide ↗

Advanced setup

claude mcp add bitbucket --transport http "https://edge.vinkius.com/vk_preview_QylYowxX5SGgCnGKgb6e2H9z4AKF53xBazfzqAf7/mcp"

Step 01

Install Claude Code

Run npm install -g @anthropic-ai/claude-code if not already installed
Step 02

Add the Connector

Run the command above in your terminal
Step 03

Verify the connection

Run claude mcp to list connected servers, or type /mcp inside a session
Step 04

Start using Bitbucket

Ask Claude: "Using Bitbucket, show me...". 10 tools are ready

Where the request belongs

Work Bitbucket can move forward.

Built around the request

This is for the engineer who spends half their day hunting for PR statuses or the DevOps lead who needs a quick pulse on build health across multiple projects.

Software Engineer

Checking PR statuses and pipeline health during a sprint without switching tabs.

DevOps Engineer

Monitoring build failures and repository activity across the whole workspace.

Team Lead

Getting a summary of recent commits and open issues for daily standups.

Build the capability set

Each Connector adds new actions and data without changing how you work.

Browse Connectors

01 12 capabilities

GitHub

Manage repositories, pull requests, issues, and CI/CD workflows on the world largest developer collaboration platform.

View Connector

02 10 capabilities

Coding.net

All-in-one DevOps platform. manage projects, repositories, and issues via AI.

View Connector

03 10 capabilities

Gitee

Collaborative code hosting and development platform. manage repositories, issues, and pull requests via AI.

View Connector

04 10 capabilities

Gerrit

Manage code reviews via Gerrit. query changes and patch sets, handle reviewers and approvals, and audit project branches directly from any AI agent.

View Connector

05 10 capabilities

Gitea

Manage self-hosted Git via Gitea. list and manage repositories, track issues and pull requests, handle organizations, and audit branches directly from any AI agent.

View Connector

06 16 capabilities

GitLab

Manage projects, track issues, and oversee CI/CD pipelines via AI agents with GitLab.

View Connector

Bring your own AI

Change the model, client or framework. Keep Bitbucket connected.

Claude
ChatGPT
Gemini
Cursor
VS Code
Windsurf
ZCode
Cline
Zed
Continue
Kiro
Roo Code
Zencoder
Goose
Void
Augment Code
Amp
Qodo
Tabnine
Pieces
Sourcegraph Cody
JetBrains
Warp
Amazon Q
Antigravity
BoltAI
Raycast
Jan
LM Studio
AnythingLLM
Open WebUI
Msty
Cherry Studio
LibreChat
TypingMind
Chorus
5ire
n8n
LangChain
LlamaIndex
CrewAI
Vercel AI SDK

Before you connect

Questions about Bitbucket.

The practical details behind the request, access and result.

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 capability 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.

One connection away

Give your agent a direct line to Bitbucket.

Connect Bitbucket once. Keep it beside 5,900+ managed Connectors when the next task needs more.

Explore every Connector No credit card required · Free tier available

Bitbucket : Automate Git Repository Oversight and PR Tracking

You get a direct line to your Bitbucket data without leaving your workflow.

Checking PR status

Build monitoring

Commit history

List commits

Get pull request

List pull requests

Get repository

Get user profile

List branches

List issues

List pipelines

List repositories

List workspaces

Open Connectors

Add the URL

Turn it on in chat

Open MCP settings

Add the URL

Save and start

Open MCP Settings

Add the server config

Save the file

Start using Bitbucket

Create MCP config

Add the server config

Enable Agent mode

Start using Bitbucket

Open MCP Settings

Add the server

Save and reload

Start using Bitbucket

Open Cline MCP Settings

Add remote server

Enable the server

Start using Bitbucket

Install Claude Code

Add the Connector

Verify the connection

Start using Bitbucket

Software Engineer

DevOps Engineer

Team Lead

GitHub

Coding.net

Gitee

Gerrit

Gitea

GitLab

Give your agent a direct line to Bitbucket.