delete_realm_role
Remove a role from a Keycloak realm to manage user permissions and access control. Specify the role name and optionally the target realm.
Instructions
Delete a realm role.
Args:
role_name: Role name to delete
realm: Target realm (uses default if not specified)
Returns:
Status message
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| role_name | Yes | ||
| realm | No |
Implementation Reference
- src/tools/role_tools.py:121-139 (handler)Handler function for delete_realm_role tool. Deletes the specified realm role using KeycloakClient and returns success status.@mcp.tool() async def delete_realm_role( role_name: str, realm: Optional[str] = None ) -> Dict[str, str]: """ Delete a realm role. Args: role_name: Role name to delete realm: Target realm (uses default if not specified) Returns: Status message """ await client._make_request("DELETE", f"/roles/{role_name}", realm=realm) return { "status": "deleted", "message": f"Realm role {role_name} deleted successfully", }