Bitbucket MCP Server — Hosted Storage, Any AI Agent
MCP Server language Hosted language PublicManage Bitbucket repositories, branches, pull requests, commits, and pipelines with natural language.
Use with AI AssistantsMCP
Connect Claude, Cursor, or any MCP-compatible client — then call tools directly
① Add This MCP Server
Paste into your AI client config — then all its tools are available instantly.
{
"mcpServers": {
"bitbucket": {
"url": "https://mcp.aerostack.dev/s/aerostack/mcp-bitbucket",
"headers": {
"Authorization": "Bearer YOUR_AEROSTACK_TOKEN"
}
}
}
}Replace YOUR_AEROSTACK_TOKEN with your API token from the dashboard.
② Call a Tool
Ask your AI assistant to call a specific tool, or send raw JSON-RPC:
Natural Language Prompt
“Use the _ping tool to verify bitbucket credentials by calling a lightweight read endpoint. used internally by aerostack to validate credentials”
Using a Workspace?
Add this MCP to your Workspace — your team shares one token, secrets are stored securely, and every AI agent in the workspace can call it without per-user setup.
description Overview
mcp-bitbucket — Bitbucket MCP Server
Manage Bitbucket repositories, branches, pull requests, commits, and pipelines with natural language.
Live endpoint: https://mcp.aerostack.dev/s/aerostack/mcp-bitbucket
What You Can Do
This MCP server gives AI agents access to Bitbucket via 14 tools. Connect it to any Aerostack workspace and your agents can interact with Bitbucket directly.
Available Tools
| Tool | Description |
|---|---|
list_repositories |
List repositories in a Bitbucket workspace |
get_repository |
Get details of a specific Bitbucket repository |
create_repository |
Create a new Bitbucket repository |
list_branches |
List branches in a Bitbucket repository |
get_branch |
Get details of a specific branch |
list_pull_requests |
List pull requests in a Bitbucket repository |
get_pull_request |
Get details of a specific pull request |
create_pull_request |
Create a new pull request in a Bitbucket repository |
merge_pull_request |
Merge a pull request |
list_commits |
List commits in a Bitbucket repository |
get_commit |
Get details of a specific commit |
list_pipelines |
List pipelines in a Bitbucket repository |
get_pipeline |
Get details of a specific pipeline |
create_pipeline |
Trigger a new pipeline in a Bitbucket repository |
Configuration
| Variable | Required | Description |
|---|---|---|
BITBUCKET_TOKEN |
Yes | Personal access token or service token from the provider |
Quick Start
Add to Aerostack Workspace
- Go to aerostack.dev → Your Project → MCPs
- Search for "Bitbucket" and click Add to Workspace
Add the following secrets under Project → Secrets:
BITBUCKET_TOKEN
Once added, every AI agent in your workspace can use Bitbucket tools automatically.
Direct API Call
curl -X POST https://mcp.aerostack.dev/s/aerostack/mcp-bitbucket \
-H 'Content-Type: application/json' \
-H 'X-Mcp-Secret-BITBUCKET-TOKEN: your-bitbucket-token' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_repositories","arguments":{}}}'
License
MIT
terminal Tools (15)
Available tools on this MCP server. Each tool can be called directly from any AI agent.
_ping #1 Verify Bitbucket credentials by calling a lightweight read endpoint. Used internally by Aerostack to validate credentials.
list_repositories #2 List repositories in a Bitbucket workspace
get_repository #3 Get details of a specific Bitbucket repository
create_repository #4 Create a new Bitbucket repository
list_branches #5 List branches in a Bitbucket repository
get_branch #6 Get details of a specific branch
list_pull_requests #7 List pull requests in a Bitbucket repository
get_pull_request #8 Get details of a specific pull request
create_pull_request #9 Create a new pull request in a Bitbucket repository
merge_pull_request #10 Merge a pull request
list_commits #11 List commits in a Bitbucket repository
get_commit #12 Get details of a specific commit
list_pipelines #13 List pipelines in a Bitbucket repository
get_pipeline #14 Get details of a specific pipeline
create_pipeline #15 Trigger a new pipeline in a Bitbucket repository
Details
language Live Endpoint
https://mcp.aerostack.dev/s/aerostack/mcp-bitbucket
Sub-50ms globally · Zero cold start
Publisher
Pre-built functions for the most common MCP tool patterns. Clone, extend, and deploy.
More in Storage
Browse Storage MCPs →Box Content Management
by @aerostack
Files, folders, search, metadata, sharing, comments, collaborations via Box's official MCP
Dropbox
by @aerostack
List, upload, download, search, move, and manage files and folders in Dropbox — AI-native cloud storage for any agent.
Google Drive
by @aerostack
List, search, upload, share, and organize files in Google Drive — AI-native document and storage management.
Pipedrive
by @aerostack
Manage deals, contacts, and sales pipelines in Pipedrive — give AI agents full access to your CRM.
Frequently asked questions
What is the Bitbucket MCP server and what can it do? +
The Bitbucket MCP server is hosted on Aerostack and exposes these tools to your AI agent: `_ping`, `list_repositories`, `get_repository`, `create_repository`, `list_branches`. You get one hosted URL — no self-hosting — that works from Claude, Cursor, ChatGPT, Gemini, VS Code, or any MCP-compatible client, and you can share it with your team or combine it with other MCP servers in a workspace.
Is the Bitbucket MCP server hosted, or do I have to run it myself? +
It's hosted on Aerostack's edge infrastructure — you don't deploy or maintain anything. Add it to a workspace and you get one authenticated URL, with secrets encrypted, that any AI agent or editor can connect to. Use it solo or share the same URL across your whole team.
Which AI agents and editors can use the Bitbucket MCP server? +
Any MCP client: Claude and Claude Code, Cursor, ChatGPT, Gemini, Windsurf, Cline, VS Code, and custom agents. Because it's one hosted URL, the same Bitbucket MCP server works everywhere — and you can compose it with other MCP servers, skills, and functions behind a single workspace URL.
How do I install the Bitbucket MCP server in Claude Desktop? +
Add the following to your Claude Desktop config (`claude_desktop_config.json`): ```json { "mcpServers": { "@aerostack/mcp-bitbucket": { "command": "npx", "args": ["-y", "@aerostack/@aerostack/mcp-bitbucket"] } } } ``` Then restart Claude Desktop and the tools will appear automatically.
How do I use the Bitbucket MCP server in Cursor? +
In Cursor, open **Settings → MCP** and add: ```json { "name": "@aerostack/mcp-bitbucket", "command": "npx", "args": ["-y", "@aerostack/@aerostack/mcp-bitbucket"] } ``` Save and reload Cursor. The MCP tools will be available in Agent mode.
Does Bitbucket MCP require authentication? +
Yes. Bitbucket requires authentication. Check the MCP's documentation for the required credentials.