remove_realm_default_group
Remove a default group from a Keycloak realm to manage user access and permissions by specifying the group ID and optional realm.
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 messageInput Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| group_id | Yes | ||
| realm | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- src/tools/realm_tools.py:246-264 (handler)The main handler function decorated with @mcp.tool(), implementing the logic to remove a group from the realm's default groups via Keycloak API. This serves as both the tool handler and its registration.
@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", }