mcp-server-bitbucket

Instructions

Args:
    repo_slug: Repository slug
    selected_user: User's account_id or UUID

Returns:
    Confirmation of removal

Implementation Reference

• src/server.py:1575-1591 (handler)

  MCP tool handler decorated with @mcp.tool(). Calls BitbucketClient.delete_user_permission to remove the specified user's permission from the repository and returns a success confirmation.

  @mcp.tool()
  @handle_bitbucket_error
  @formatted
  def delete_user_permission(repo_slug: str, selected_user: str) -> dict:
      """Remove a user's explicit permission from a repository.
  
      Args:
          repo_slug: Repository slug
          selected_user: User's account_id or UUID
  
      Returns:
          Confirmation of removal
      """
      client = get_client()
      client.delete_user_permission(repo_slug, selected_user)
      return {}

• src/bitbucket_client.py:1557-1574 (helper)

  BitbucketClient helper method that makes the DELETE API request to /repositories/{workspace}/{repo_slug}/permissions-config/users/{selected_user} to remove the user's permission.

  def delete_user_permission(
      self, repo_slug: str, selected_user: str
  ) -> bool:
      """Remove user permission from repository.
  
      Args:
          repo_slug: Repository slug
          selected_user: User UUID or account_id
  
      Returns:
          True if deleted successfully
      """
      self._request(
          "DELETE",
          self._repo_path(repo_slug, "permissions-config", "users", selected_user),
      )
      return True

• src/models.py:629-644 (schema)

  Pydantic model used for parsing and validating user permission data from Bitbucket API responses, relevant for permission-related tools including delete operations.

  class UserPermission(BaseModel):
      """User permission info."""
  
      user: Optional[str] = None
      account_id: Optional[str] = None
      permission: str
  
      @classmethod
      def from_api(cls, data: dict) -> "UserPermission":
          user_data = data.get("user") or {}
          return cls(
              user=user_data.get("display_name"),
              account_id=user_data.get("account_id"),
              permission=data.get("permission", ""),
          )

• src/server.py:1575-1575 (registration)

  @mcp.tool() decorator registers the delete_user_permission function as an MCP tool.

  @mcp.tool()