mcp-keycloak

Instructions

Get realm roles for a user.

Args:
    user_id: User ID
    effective: Get effective roles (including composite roles)
    realm: Target realm (uses default if not specified)

Returns:
    List of realm roles

Implementation Reference

• src/tools/role_tools.py:268-288 (handler)

  The @mcp.tool()-decorated handler function that implements the core logic for retrieving a user's realm roles from Keycloak, including support for effective roles.

  @mcp.tool()
  async def get_user_realm_roles(
      user_id: str, effective: bool = False, realm: Optional[str] = None
  ) -> List[Dict[str, Any]]:
      """
      Get realm roles for a user.
  
      Args:
          user_id: User ID
          effective: Get effective roles (including composite roles)
          realm: Target realm (uses default if not specified)
  
      Returns:
          List of realm roles
      """
      endpoint = f"/users/{user_id}/role-mappings/realm"
      if effective:
          endpoint += "/composite"
  
      return await client._make_request("GET", endpoint, realm=realm)