mcp-keycloak

Instructions

Get members of a group.

Args:
    group_id: Group ID
    first: Pagination offset
    max: Maximum results size
    realm: Target realm (uses default if not specified)

Returns:
    List of group members

Implementation Reference

• src/tools/group_tools.py:140-167 (handler)

  The main handler function for the 'get_group_members' tool. It is decorated with @mcp.tool() which registers it as an MCP tool. The function fetches members of a specified group from Keycloak using the KeycloakClient, supporting pagination and realm specification. The docstring provides the input schema description.

  @mcp.tool()
  async def get_group_members(
      group_id: str,
      first: Optional[int] = None,
      max: Optional[int] = None,
      realm: Optional[str] = None,
  ) -> List[Dict[str, Any]]:
      """
      Get members of a group.
  
      Args:
          group_id: Group ID
          first: Pagination offset
          max: Maximum results size
          realm: Target realm (uses default if not specified)
  
      Returns:
          List of group members
      """
      params = {}
      if first is not None:
          params["first"] = first
      if max is not None:
          params["max"] = max
  
      return await client._make_request(
          "GET", f"/groups/{group_id}/members", params=params, realm=realm
      )