atlacp

An MCP (Model Context Protocol) interface for Bitbucket.

Features

Supported tools

• bitbucket_add_pr_comment - add a comment to a pull request
• bitbucket_approve_pr - approve a pull request
• bitbucket_create_pr - create a pull request
• bitbucket_create_pr_task - create a task on a pull request
• bitbucket_get_file_content - get the content of a file in a pull request
• bitbucket_get_pr_diff - get the diff of a pull request
• bitbucket_get_pr_diffstat - get the diffstat of a pull request
• bitbucket_list_pr_tasks - list tasks on a pull request
• bitbucket_merge_pr - merge a pull request
• bitbucket_read_pr - read a pull request
• bitbucket_request_pr_changes - request changes on a pull request
• bitbucket_update_pr - update a pull request
• bitbucket_update_pr_task - update a task on a pull request

Supported transports

• Streamable HTTP (default)
• SSE
• STDIO

Quick Start

See detailed version here

Configure accounts

The tool is designed to be running locally on developer's machine. In order to run the tool you need to configure your Atlassian accounts first. For bitbucket you need to create a personal access token that can read and write to the repository.

Example atlassian-accounts.json file:

{
  "accounts": [
    {
      "name": "user",
      "default": true,
      "bitbucket": { "type": "Basic", "value": "ATBBxxxxxxxxxxxxxxxx" }
    }
  ]
} 

You may optionally configure multiple accounts for different roles or different workspaces, for example you may have user and bot accounts. See quick-start/atlassian-accounts-stub.json for more details.

More on Atlassian tokens:

• Personal API Tokens (keep in mind to create a basic token for API use). When using personal access tokens, all requests will be made on behalf of the user.
• Bitbucket Access Tokens - good for bots and other automation tools.

Start the MCP server

Start docker container pointing on the atlassian-accounts.json file:

docker run -d --name atlacp-mcp \
  --restart=always \
  -p 8080:8080 \
  -v $(pwd)/atlassian-accounts.json:/app/atlassian-accounts.json \
  ghcr.io/gemyago/atlacp-mcp:latest \
  -a /app/atlassian-accounts.json \
  http

Integrate AI tools

Cursor MCP config (.cursor/mcp.json) section may look like this:

{
  "mcpServers": {
    "Atlassian MCP": {
      "url": "http://localhost:8080"
    }
  }
}

Once configured, try to send a prompt to the editor, similar to below:

Check pull request 12345 from bitbucket repo owner/repo-name

You should see a response with PR details.

Pick appropriate transport

Root url will serve Streamable HTTP transport. You can use SSE transport by appending /sse to the root url. Example:

• http://localhost:8080 - Streamable HTTP transport
• http://localhost:8080/sse - SSE transport

STDIO is supported as well. Use docker run with stdio subcommand instead of http to use it.

License

MIT