delete_realm_role
Remove a specific role from a Keycloak realm by providing the role name and optional realm. Streamline role management and access control with this targeted deletion tool.
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 |
|---|---|---|---|
| realm | No | ||
| role_name | Yes |
Implementation Reference
- src/tools/role_tools.py:121-139 (handler)The async handler function for the 'delete_realm_role' MCP tool, decorated with @mcp.tool(). It deletes the specified realm role by making a DELETE request to the Keycloak API endpoint /roles/{role_name} using the shared KeycloakClient instance.@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", }