Skip to content

Introduction

bbkt is a dual-mode Command-Line Interface and Model Context Protocol (MCP) server that gives users and AI assistants full access to your Bitbucket repositories.

Instead of relying on web scraping or manual context-dropping, this tool directly interfaces with the Bitbucket REST API v2 to expose repository context to any terminal session or MCP-compliant client.

  • Fast & lightweight: Built in Go without heavy runtime dependencies.
  • Deep integration: Create pull requests, merge code, approve reviews, and resolve inline comments cleanly.
  • Multi-account: Built-in profile system stores credentials for personal vs work accounts side-by-side; auto-selects the right one based on the workspace of your current git clone.
  • Self-contained auth: Scoped Atlassian API tokens or interactive OAuth 2.0 flows on local workstations; classic (unscoped) tokens are detected and rejected with an actionable message.
  1. Install bbkt
  2. Configure your MCP client