Mentionable
Mentionable

remove_geo_audit_recommendation

remove_geo_audit_recommendation MCP tool: remove a custom recommendation from a GEO Audit by its id.

Updated 2026-07-23

remove_geo_audit_recommendation removes a custom recommendation from a GEO Audit by its id. Only custom recommendations (those added via add_geo_audit_recommendation or by hand) can be removed; AI-generated recommendations are frozen and can only be hidden. Tenant-scoped write, single audits only.

When to use

To undo a custom recommendation an agent or owner added. Get the id from list_geo_audit_recommendations (the custom[].id field).

Input

Field Type Description
auditId string (CUID) The GEO Audit id.
customRecoId string The id of the custom recommendation to remove.

GEO Audits are workspace-scoped, so this tool takes no projectId. Requires a non read-only API key.

Response

Success

{ "success": true, "auditId": "clx_audit_42", "removed": true }

removed is false when no custom recommendation matched that id (already gone, or the id belongs to a generated recommendation). The call still succeeds — it is idempotent.

Errors

{ "success": false, "error": "audit_not_found", "message": "No GEO audit with this id exists in your workspace. ..." }
{ "success": false, "error": "bulk_unsupported", "message": "This audit is part of a bulk campaign; its recommendations are managed at the campaign level, not via this tool." }

Tips and patterns

  • Use the custom[].id from list_geo_audit_recommendations. Generated recommendations expose a hash, not an id, and are not removable here.
  • Idempotent: removing an already-removed id returns removed: false rather than an error.

Related tools