mcp-server-bitbucket

Instructions

Implementation Reference

• src/server.py:1172-1189 (handler)

  MCP tool handler: lists repository webhooks via BitbucketClient, formats output using WebhookSummary Pydantic model
  @mcp.tool() @handle_bitbucket_error @formatted def list_webhooks(repo_slug: str, limit: int = 50) -> dict: """List webhooks configured for a repository. Args: repo_slug: Repository slug limit: Maximum number of results (default: 50) Returns: List of webhooks with URL, events, and status """ client = get_client() webhooks = client.list_webhooks(repo_slug, limit=validate_limit(limit)) return { "webhooks": [WebhookSummary.from_api(w).model_dump() for w in webhooks], }
• src/models.py:457-482 (schema)

  Pydantic output model WebhookSummary: defines structure and validation for webhook list responses, with from_api factory method
  class WebhookSummary(BaseModel): """Webhook info for list responses.""" uuid: str url: str description: str = "" events: list[str] = [] active: bool = True created: Optional[str] = None @field_validator("created", mode="before") @classmethod def truncate_ts(cls, v: Any) -> Optional[str]: return truncate_timestamp(v) @classmethod def from_api(cls, data: dict) -> "WebhookSummary": return cls( uuid=data.get("uuid", ""), url=data.get("url", ""), description=data.get("description", ""), events=data.get("events", []), active=data.get("active", True), created=data.get("created_at"), )
• src/server.py:1172-1174 (registration)

  Tool registration via @mcp.tool() decorator on the handler function
  @mcp.tool() @handle_bitbucket_error @formatted
• src/bitbucket_client.py:1158-1175 (helper)

  BitbucketClient helper method: performs paginated GET request to Bitbucket API /hooks endpoint
  def list_webhooks( self, repo_slug: str, limit: int = 50, ) -> list[dict[str, Any]]: """List webhooks for a repository. Args: repo_slug: Repository slug limit: Maximum results to return Returns: List of webhook info dicts """ return self._paginated_list( self._repo_path(repo_slug, "hooks"), limit=limit, )