remove_realm_default_group
Remove a designated default group from a specified Keycloak realm. Input the group ID and optionally the target realm to update realm-level configurations efficiently.
Instructions
Remove a default group from the realm.
Args:
group_id: Group ID to remove from defaults
realm: Target realm (uses default if not specified)
Returns:
Status message
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| group_id | Yes | ||
| realm | No |
Implementation Reference
- src/tools/realm_tools.py:246-264 (handler)The main handler function for the 'remove_realm_default_group' tool. It uses the KeycloakClient to send a DELETE request to remove the specified group_id from the realm's default groups and returns a success message.@mcp.tool() async def remove_realm_default_group( group_id: str, realm: Optional[str] = None ) -> Dict[str, str]: """ Remove a default group from the realm. Args: group_id: Group ID to remove from defaults realm: Target realm (uses default if not specified) Returns: Status message """ await client._make_request("DELETE", f"/default-groups/{group_id}", realm=realm) return { "status": "removed", "message": f"Group {group_id} removed from default groups", }
- src/tools/realm_tools.py:246-246 (registration)The @mcp.tool() decorator registers this function as an MCP tool named 'remove_realm_default_group', inferred from the function name.@mcp.tool()
- src/tools/realm_tools.py:247-249 (schema)Function signature defines the input schema (group_id: str required, realm: Optional[str]) and output type (Dict[str, str]). The docstring provides additional description used for tool schema.async def remove_realm_default_group( group_id: str, realm: Optional[str] = None ) -> Dict[str, str]: