AdCopilot docsby Atromx
Tool reference

AdCopilot tools

The two calls every conversation uses, get_org_context to start and save_org_context to remember your business. Neither counts against your daily operations.

View as Markdown
Open inClaudePerplexity

Two tools belong to AdCopilot itself rather than to a Google product. They work on every plan, with nothing connected, and neither counts against your daily operations.

get_org_context

Read. The starting point of every conversation. It returns what this workspace has connected, which Google Ads accounts are switched on, the state the account is in, your saved business profile, your plan and today's usage, and the next step. The assistant calls it before any other tool, and does what it says. If AdCopilot's daily check of your Search Console sites found that Google is not showing a site's home page, or that the searches finding it fell sharply, it says that first (the daily site check).

Get me started with AdCopilot

It also keeps your assistant's tool list honest:

  • If your connection is missing tools that exist now, it says how many, names a few, and says how to reconnect your assistant.
  • Every tool description ends with a line Tools revision: <code>. get_org_context reports the current code. If a description your assistant holds ends with a different code, or the line is missing, get_org_context(tools=[…]) returns the current text of up to ten named tools.

See A tool is missing or out of date.

With more than one Google Ads account, it returns the business profile of the account your assistant is working on. An account without a profile of its own uses your business's.

save_org_context

Write. Saves what you told AdCopilot about your business (what you sell, where your customers are, your comfortable daily budget and monthly cap), how far you have got, and a note of the session, so the next conversation carries on from there. It saves only what you said. The budget checks use the daily budget and monthly cap it saves, and How your data moves says how long the profile is kept.

With more than one Google Ads account, it saves to the profile of the account you are working on, such as a client's. The first time, your assistant asks whether the account is your own business or a client's.

A value it saves replaces the one saved before, and the earlier value is not kept. So AdCopilot marks this tool as one that can overwrite data, and your AI client may ask before each save.

Some things cannot be changed from a conversation: how much you already know about Google Ads (it changes what AdCopilot lets the assistant do) and the record of the first campaign AdCopilot built with you. Those are on the dashboard's Business profile page. A viewer, or a read-only workspace, cannot save.

confirm_changes

Not listed. From v2.46.16 to v2.46.20, a Google Ads change tool only previewed its change, and confirm_changes made it. Since v2.46.21 a Google Ads change is made when its tool is called, and your AI client's own permission prompt is the check: for a hard stop, set it to ask before AdCopilot's write tools (Needs approval in Claude; in Cursor, the Allowlist run mode with them left off the list). The one exception is a conversation whose AI app still holds the older tool list: it keeps the preview, and confirm_changes still makes its changes, until the app loads the list fresh, in that conversation or another one. See A tool is missing or out of date.

On this page