# Bitbucket MCP events

Bitbucket's webhook events are available to agents as MCP events through Hookdeck Event Gateway.

These pages cover Bitbucket Cloud. Bitbucket Data Center is a separate self-managed product, with its own event keys, such as `repo:refs_changed`, and [its own webhook docs](https://confluence.atlassian.com/bitbucketserver/manage-webhooks-938025878.html).

Agent skill: `npx skills add hookdeck/webhook-skills --skill bitbucket-webhooks` ([details](https://hookdeck.com/webhooks/bitbucket/skill))

> Independent reference generated from hookdeck/webhook-registry (commit a24c8d9, 19 Nov 2026). [Bitbucket's official docs](https://support.atlassian.com/bitbucket-cloud/docs/event-payloads/).

[Overview](https://hookdeck.com/webhooks/bitbucket) · [Webhook events (29)](https://hookdeck.com/webhooks/bitbucket/events) · [MCP events](https://hookdeck.com/webhooks/bitbucket/mcp-events) · [Verify signatures](https://hookdeck.com/webhooks/bitbucket/verify) · [Production guide](https://hookdeck.com/webhooks/bitbucket/guide-duplicates-retries-timeouts) · [Agent skill](https://hookdeck.com/webhooks/bitbucket/skill)

## Bitbucket's MCP server

Atlassian's MCP server connects AI tools to Bitbucket Cloud, Jira, Confluence and other Atlassian apps, so they can read repositories and pull requests, and create or update pull requests. Its Bitbucket tools need a workspace linked to an organization. Those tools call Bitbucket, and its docs don't describe them delivering webhook events. To get Bitbucket's events into an agent, subscribe it through Hookdeck Event Gateway, as described below. [Bitbucket's MCP docs](https://support.atlassian.com/atlassian-rovo-mcp-server/docs/supported-tools/)

## How to subscribe

1. Connect your agent to Hookdeck's MCP server ([MCP Events bridge](https://hookdeck.com/blog/mcp-events-bridge)).
2. Point your Bitbucket webhook at a Hookdeck source.
3. Your agent lists the available events and subscribes to the ones it needs.

## Events

| Webhook event | MCP event |
|---|---|
| [repo:push](https://hookdeck.com/webhooks/bitbucket/events#repo%3Apush) | `bitbucket.repo:push` |
| [repo:fork](https://hookdeck.com/webhooks/bitbucket/events#repo%3Afork) | `bitbucket.repo:fork` |
| [repo:updated](https://hookdeck.com/webhooks/bitbucket/events#repo%3Aupdated) | `bitbucket.repo:updated` |
| [repo:transfer](https://hookdeck.com/webhooks/bitbucket/events#repo%3Atransfer) | `bitbucket.repo:transfer` |
| [repo:commit_comment_created](https://hookdeck.com/webhooks/bitbucket/events#repo%3Acommit_comment_created) | `bitbucket.repo:commit_comment_created` |
| [repo:commit_status_created](https://hookdeck.com/webhooks/bitbucket/events#repo%3Acommit_status_created) | `bitbucket.repo:commit_status_created` |
| [repo:commit_status_updated](https://hookdeck.com/webhooks/bitbucket/events#repo%3Acommit_status_updated) | `bitbucket.repo:commit_status_updated` |
| [repo:deleted](https://hookdeck.com/webhooks/bitbucket/events#repo%3Adeleted) | `bitbucket.repo:deleted` |
| [repo:created](https://hookdeck.com/webhooks/bitbucket/events#repo%3Acreated) | `bitbucket.repo:created` |
| [repo:imported](https://hookdeck.com/webhooks/bitbucket/events#repo%3Aimported) | `bitbucket.repo:imported` |
| [project:updated](https://hookdeck.com/webhooks/bitbucket/events#project%3Aupdated) | `bitbucket.project:updated` |
| [pullrequest:created](https://hookdeck.com/webhooks/bitbucket/events#pullrequest%3Acreated) | `bitbucket.pullrequest:created` |
| [pullrequest:updated](https://hookdeck.com/webhooks/bitbucket/events#pullrequest%3Aupdated) | `bitbucket.pullrequest:updated` |
| [pullrequest:push](https://hookdeck.com/webhooks/bitbucket/events#pullrequest%3Apush) | `bitbucket.pullrequest:push` |
| [pullrequest:changes_request_created](https://hookdeck.com/webhooks/bitbucket/events#pullrequest%3Achanges_request_created) | `bitbucket.pullrequest:changes_request_created` |
| [pullrequest:changes_request_removed](https://hookdeck.com/webhooks/bitbucket/events#pullrequest%3Achanges_request_removed) | `bitbucket.pullrequest:changes_request_removed` |
| [pullrequest:approved](https://hookdeck.com/webhooks/bitbucket/events#pullrequest%3Aapproved) | `bitbucket.pullrequest:approved` |
| [pullrequest:unapproved](https://hookdeck.com/webhooks/bitbucket/events#pullrequest%3Aunapproved) | `bitbucket.pullrequest:unapproved` |
| [pullrequest:fulfilled](https://hookdeck.com/webhooks/bitbucket/events#pullrequest%3Afulfilled) | `bitbucket.pullrequest:fulfilled` |
| [pullrequest:rejected](https://hookdeck.com/webhooks/bitbucket/events#pullrequest%3Arejected) | `bitbucket.pullrequest:rejected` |
| [pullrequest:comment_created](https://hookdeck.com/webhooks/bitbucket/events#pullrequest%3Acomment_created) | `bitbucket.pullrequest:comment_created` |
| [pullrequest:comment_updated](https://hookdeck.com/webhooks/bitbucket/events#pullrequest%3Acomment_updated) | `bitbucket.pullrequest:comment_updated` |
| [pullrequest:comment_deleted](https://hookdeck.com/webhooks/bitbucket/events#pullrequest%3Acomment_deleted) | `bitbucket.pullrequest:comment_deleted` |
| [pullrequest:comment_resolved](https://hookdeck.com/webhooks/bitbucket/events#pullrequest%3Acomment_resolved) | `bitbucket.pullrequest:comment_resolved` |
| [pullrequest:comment_reopened](https://hookdeck.com/webhooks/bitbucket/events#pullrequest%3Acomment_reopened) | `bitbucket.pullrequest:comment_reopened` |
| [issue:created](https://hookdeck.com/webhooks/bitbucket/events#issue%3Acreated) | `bitbucket.issue:created` |
| [issue:updated](https://hookdeck.com/webhooks/bitbucket/events#issue%3Aupdated) | `bitbucket.issue:updated` |
| [issue:comment_created](https://hookdeck.com/webhooks/bitbucket/events#issue%3Acomment_created) | `bitbucket.issue:comment_created` |
| [pipeline:span_created](https://hookdeck.com/webhooks/bitbucket/events#pipeline%3Aspan_created) | `bitbucket.pipeline:span_created` |
---

Not affiliated with Bitbucket. Facts are compiled from public sources and linked inline. [View as JSON](https://hookdeck.com/webhooks/bitbucket.json) · [Report a correction](https://hookdeck.com/contact)
