delete_group
Remove a specific group from the Keycloak identity and access management system. Specify the group ID and optionally the target realm to execute the deletion and receive a status confirmation.
Instructions
Delete a group.
Args:
group_id: Group ID
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/group_tools.py:124-137 (handler)The handler function for the 'delete_group' MCP tool. It is decorated with @mcp.tool() for registration and implements the deletion logic using KeycloakClient._make_request.@mcp.tool() async def delete_group(group_id: str, realm: Optional[str] = None) -> Dict[str, str]: """ Delete a group. Args: group_id: Group ID realm: Target realm (uses default if not specified) Returns: Status message """ await client._make_request("DELETE", f"/groups/{group_id}", realm=realm) return {"status": "deleted", "message": f"Group {group_id} deleted successfully"}