Mentionable
Mentionable

add_geo_audit_recommendation

add_geo_audit_recommendation MCP tool: add a custom recommendation to a GEO Audit report, same as an owner can by hand.

Updated 2026-07-23

add_geo_audit_recommendation adds a custom recommendation to a GEO Audit report, exactly like an owner can do by hand in the audit UI. It lets an agent enrich an audit with its own recommendations programmatically. Tenant-scoped write, single audits only.

When to use

After reading the audit and its existing recommendations (get_geo_audit, list_geo_audit_recommendations), add the recommendations your workflow generated. The new recommendation appears in the audit report alongside the AI-generated ones.

Input

Field Type Description
auditId string (CUID) The GEO Audit id returned by list_geo_audits.
category enum technical, content, or distribution.
severity enum critical, important, or nice-to-have.
title string 1–160 chars.
description string 1–1200 chars.

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",
  "reco": {
    "id": "cus_ab12cd34",
    "category": "content",
    "severity": "important",
    "title": "Publish a head-to-head comparison page",
    "description": "Cover the three competitors named most often by the LLMs."
  }
}

The returned reco.id is the handle to remove it later with remove_geo_audit_recommendation.

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

  • List first with list_geo_audit_recommendations to avoid duplicating an existing recommendation.
  • Keep titles specific. The title is what readers scan; put the action in it (for example "Add FAQ schema to the pricing page").
  • Custom recommendations are editable: remove them with remove_geo_audit_recommendation. Generated ones are frozen.

Related tools