AdCopilot docsby Atromx
Core concepts

Read vs write tools

Reads run freely and writes are proposed first. For a hard stop, set your AI client to ask before writes (Needs approval in Claude, Allowlist in Cursor).

View as Markdown
Open inClaudePerplexity

Every tool is either a read or a write. Reads run freely. Writes change something in your account, so the assistant proposes them first. For a hard stop, set your AI client to ask before AdCopilot's write tools: Needs approval in Claude; in Cursor, set the run mode to Allowlist and keep them off the allowlist (Cursor's cloud agents never ask). See Approval-gated writes.

Four of the write tools, the ones that build a campaign or can start or raise its spend, are also checked against the budget you saved, on AdCopilot's server; see The budget checks.

The split, by product

Counted on the whole list, which is the same whichever products are connected:

ProductToolsReadWrite
Google Ads772948
Google Analytics 4291514
Search Console853
Tag Manager1899
Google Sheets101
AdCopilot211
All1355976

The Google Ads reads include search (any report, in Google's query language), list_accessible_customers, get_resource_metadata, list_asset_links, list_auto_apply_subscriptions, list_recommendations, list_audiences, the three keyword research tools (get_keyword_ideas, get_keyword_metrics and get_keyword_forecast) and every analysis tool, from full_audit to day_of_week, change_history, explain_conversion_gap and paid_vs_organic, performance_report (a performance table at one level, with Google's standard columns), list_portfolio_bidding_strategies, and pagespeed_check, how fast a web page loads. The reading tools are described on Read and report tools and the audit tools on Analysis and audit tools; the tool reference marks every tool Read or Write.

The AdCopilot pair is get_org_context (read: what is connected, and where you stand) and save_org_context (write: saves what you told it about your business, so the next conversation remembers).

Read-only access

You can narrow what AdCopilot may change:

  • Google Analytics and Tag Manager can be connected with Read-only access. Their write tools stay unavailable until you press Enable editing in Google products.
  • A teammate with the viewer role can read but not change anything. The owner sets roles on the Team page, and when inviting someone.
  • A whole workspace can be put on the read-only tier. Every write tool is removed on our server. Ask support@adcopilot.cloud.

How to tell, in practice

  • If the assistant is answering a question, it is reading.
  • If the assistant is proposing a change and asking for your yes, it is about to write. That pause is the signal.

On this page