delete_guide

Preview

This feature is in preview and is subject to change.

Soft-delete a Guide, identified by UUID. The version history is preserved for audit purposes.

Description

The delete_guide tool removes a guide from the active catalog. The guide's version history is retained internally but is not exposed through normal tools after deletion. Only the guide's owner can delete it.

References from other guides to a deleted guide are left dangling and resolve to not-found — clean them up in the referencing guides if needed.

There is no undo through the MCP tools — if you delete a guide by mistake, contact MotherDuck support.

warning

Deleting an org-wide guide removes it from all users' guide catalogs immediately. Verify you have the right guide (read it with get_guide) before confirming deletion.

Input parameters

Parameter	Type	Required	Description
uuid	string	Yes	The guide's UUID, as returned by list_guides or a previous mutation.

Output schema

{
  "success": boolean,
  "deleted": boolean,  // true when the guide was successfully deleted
  "error": string      // Error message (on failure)
}

Example usage

Delete a guide:

Delete the outdated order-management guide

The assistant finds the guide's UUID with list_guides, verifies it's the right one, and calls:

{
  "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Success response example

{
  "success": true,
  "deleted": true
}

Related

• list_guides — Find the guide's UUID before deleting.
• get_guide — Verify the guide content before deleting.
• Guides how-to — Step-by-step instructions for creating and managing Guides.