mcp-server-bitbucket

Instructions

Args:
    repo_slug: Repository slug
    limit: Maximum number of results (default: 50)

Returns:
    List of users with their permission levels

Implementation Reference

• src/server.py:1508-1525 (handler)

  MCP tool handler function (registered via @mcp.tool()) that executes the list_user_permissions tool logic: fetches from BitbucketClient, applies validation, formats output using UserPermission Pydantic models.

  @mcp.tool()
  @handle_bitbucket_error
  @formatted
  def list_user_permissions(repo_slug: str, limit: int = 50) -> dict:
      """List user permissions for a repository.
  
      Args:
          repo_slug: Repository slug
          limit: Maximum number of results (default: 50)
  
      Returns:
          List of users with their permission levels
      """
      client = get_client()
      permissions = client.list_user_permissions(repo_slug, limit=validate_limit(limit))
      return {
          "users": [UserPermission.from_api(p).model_dump() for p in permissions],
      }

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

  Pydantic BaseModel for UserPermission providing input/output schema validation, parsing from Bitbucket API responses, and clean serialization for tool output.

  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/bitbucket_client.py:1498-1515 (helper)

  BitbucketClient class method implementing the core API interaction: paginated GET request to /repositories/{workspace}/{repo_slug}/permissions-config/users endpoint.

  def list_user_permissions(
      self,
      repo_slug: str,
      limit: int = 50,
  ) -> list[dict[str, Any]]:
      """List user permissions for a repository.
  
      Args:
          repo_slug: Repository slug
          limit: Maximum results to return
  
      Returns:
          List of user permission info dicts
      """
      return self._paginated_list(
          self._repo_path(repo_slug, "permissions-config", "users"),
          limit=limit,
      )