Skip to main content

Droost: Entity Delete

droost_entity_delete Write (gated)

Module: Droost core

Deletes one entity by id, requiring confirm=true. Works on config entities too (blocks, stale Canvas components) — the message routes you elsewhere when a better tool exists. Gated.

Example call
{
    "tool": "droost_entity_delete",
    "arguments": {
        "entity_type": "node",
        "id": "9999",
        "confirm": true
    }
}
Example response — captured live on this site
{
    "success": false,
    "message": "This tool is disabled. Enable it with: drush config:set droost.settings allow_destructive true (or via Admin → Configuration → Development → Droost), then reload the MCP server in your editor — the running server caches this flag at startup and will keep refusing until it is restarted. (To disable later, use --input-format=yaml false so the value is stored as a real boolean.)",
    "data": null
}

Deletes a single entity by ID. Requires confirm: true. Refuses to delete protected accounts (user 0 and user 1). Disabled unless droost.settings.allow_destructive is on, and only over the CLI/STDIO transport.

Input schema (JSON Schema)
{
    "type": "object",
    "properties": {
        "entity_type": {
            "type": "string",
            "description": "Entity type machine name, e.g. \"node\", \"user\"."
        },
        "id": {
            "type": "string",
            "description": "The ID of the entity to delete."
        },
        "confirm": {
            "type": "boolean",
            "description": "Required: set true to acknowledge this is a destructive delete."
        }
    },
    "required": [
        "entity_type",
        "id",
        "confirm"
    ]
}