# AdCopilot documentation

> AdCopilot by Atromx is the AI agent that runs your Google Ads. You add one connector to the AI assistant you already use (ChatGPT, Claude, Claude Code, Codex, Gemini CLI or any MCP client), sign in with your own Google account, and ask. It reads Google Ads, Google Analytics 4, Search Console and Tag Manager, changes them only when you ask, and can never delete.

Every link below is the page's plain-text markdown. The same page as HTML lives at the "Source" URL printed at the top of each file. The whole corpus in one file: https://adcopilot.cloud/docs/llms-full.txt

- [AdCopilot documentation](https://adcopilot.cloud/docs/llms.mdx/docs/index.md): AdCopilot is the AI agent that runs your Google Ads. Add one connector to ChatGPT, Claude or any MCP client, sign in with Google, and ask. It changes things only when you ask, and it can never delete.
- Getting started
  - [Getting started](https://adcopilot.cloud/docs/llms.mdx/docs/getting-started.md): What you need, and the three steps from sign-up to your first answer — connect your Google products, add AdCopilot to your AI assistant, and say "Get me started with AdCopilot".
  - [Connect Google Ads](https://adcopilot.cloud/docs/llms.mdx/docs/getting-started/connect-google-ads.md): Connect Google Ads, and optionally Analytics, Search Console and Tag Manager, with your own Google sign-in. Choose which ad accounts AdCopilot works on, then add the connector to your assistant.
  - [Run your first audit](https://adcopilot.cloud/docs/llms.mdx/docs/getting-started/first-audit.md): Say "Get me started with AdCopilot" — AdCopilot reads what you have connected, tells you what state your account is in, and gives you the next step. Then run the read-only morning audit or a full audit.
  - [Reconnecting](https://adcopilot.cloud/docs/llms.mdx/docs/getting-started/reconnect.md): When Google stops accepting AdCopilot's sign-in, when your assistant needs to pick up tools a release added, or when Connections says it needs re-authorization — how to fix each without changing anything in your accounts.
- Connect your assistant
  - [Connect your assistant](https://adcopilot.cloud/docs/llms.mdx/docs/connect.md): One connector URL for every AI assistant. Pick yours — ChatGPT, Claude, Claude Code, Codex, Gemini CLI or any MCP client — and follow its steps.
  - [Connect ChatGPT](https://adcopilot.cloud/docs/llms.mdx/docs/connect/chatgpt.md): Add AdCopilot to ChatGPT in developer mode — turn developer mode on, create the app with the connector URL, sign in and approve, then type @AdCopilot in a new chat. Works on ChatGPT's Free plan.
  - [Connect Claude](https://adcopilot.cloud/docs/llms.mdx/docs/connect/claude.md): Add AdCopilot to Claude on the web or desktop as a custom connector — open Add custom connector, paste the URL, connect and approve, let read-only tools run without asking, then say "Get me started with AdCopilot". Works on Claude's Free plan.
  - [Connect Claude Code and Codex](https://adcopilot.cloud/docs/llms.mdx/docs/connect/claude-code.md): In Claude Code, install the AdCopilot plugin or add the connector with one command. In Codex, one command. Then approve it in your browser and ask from the terminal.
  - [The Claude Code plugin](https://adcopilot.cloud/docs/llms.mdx/docs/connect/claude-code-plugin.md): For developers on Claude Code. The AdCopilot plugin registers the connector for you and adds three skills and five commands. What it contains, how to install it, and what to do if you added the connector by hand first.
  - [Connect Gemini CLI](https://adcopilot.cloud/docs/llms.mdx/docs/connect/gemini-cli.md): Add AdCopilot to Gemini CLI with one command over HTTP, sign in, and ask from the terminal.
  - [Any MCP client](https://adcopilot.cloud/docs/llms.mdx/docs/connect/any-mcp-client.md): Cursor, Windsurf, Microsoft Copilot or any client that speaks the Model Context Protocol — add the connector URL, approve it, and ask.
- Core concepts
  - [Approval-gated writes](https://adcopilot.cloud/docs/llms.mdx/docs/concepts/approval-gated-writes.md): AdCopilot reads freely and changes things only when you ask. Approval is your AI client's own tool-permission prompt, and a set of limits holds on AdCopilot's server whatever the client allows.
  - [It can never delete](https://adcopilot.cloud/docs/llms.mdx/docs/concepts/can-never-delete.md): AdCopilot exposes no delete tool for any product and refuses any change that sets something to REMOVED. You pause instead. Deleting is something you do yourself, in Google's own interface.
  - [The budget checks](https://adcopilot.cloud/docs/llms.mdx/docs/concepts/money-fence.md): The limits AdCopilot's server applies to anything that can start or raise spend — the comfortable daily budget (a warning), the monthly cap (a refusal), Maximize Clicks with no per-click cap (a refusal), and the campaign it built (yours to switch on).
  - [Read vs write tools](https://adcopilot.cloud/docs/llms.mdx/docs/concepts/read-vs-write.md): Every AdCopilot tool either reads or writes. Reads run freely; writes change something and wait for your yes. 41 of the 103 tools read as of v2.16.0, whichever products are connected.
  - [How your data moves](https://adcopilot.cloud/docs/llms.mdx/docs/concepts/data-transit.md): AdCopilot is a connector, not a data warehouse. Queries run live against your Google accounts; here is what it keeps from them, and for how long.
  - [Accounts and scope](https://adcopilot.cloud/docs/llms.mdx/docs/concepts/accounts-and-scope.md): Which Google Ads accounts an assistant can act on — what your Google sign-in can open, the accounts you switch on, and the number your plan allows.
- Guides
  - [The daily routine](https://adcopilot.cloud/docs/llms.mdx/docs/guides/daily-routine.md): Run AdCopilot's morning Google Ads audit — a fixed, read-only six-check sequence that reports spend, wasted spend, negatives, disapprovals, and pacing, then proposes approval-gated fixes.
  - [Negative-keyword sweep](https://adcopilot.cloud/docs/llms.mdx/docs/guides/negative-keyword-sweep.md): Find the search terms spending with nothing to show, and block the clearly off-intent ones with negative keywords — on a campaign, in a shared list, or across the account. Every negative is proposed first.
  - [Campaign and keyword changes](https://adcopilot.cloud/docs/llms.mdx/docs/guides/campaign-keyword-changes.md): Create campaigns and ad groups, add and adjust keywords, change bidding, pause what is underperforming — in plain words, each change proposed first, nothing deleted.
  - [Billing and plans](https://adcopilot.cloud/docs/llms.mdx/docs/guides/billing-and-plans.md): AdCopilot's plans are sized by how many Google Ads accounts you run, with a daily operations cap. A new workspace starts on a 7-day Pro trial and moves to Free — never a lockout.
  - [Team and seats](https://adcopilot.cloud/docs/llms.mdx/docs/guides/team-and-seats.md): Invite teammates to a workspace to share connected accounts. Each plan includes seats and more are a paid add-on; plans themselves are sized by accounts, not seats.
- Tool reference
  - [Tool reference](https://adcopilot.cloud/docs/llms.mdx/docs/tools.md): Every AdCopilot tool, by product — 103 on the full tier, whichever of Google Ads, Google Analytics 4, Search Console and Tag Manager are connected. The four Google Ads remove tools are never exposed.
  - [AdCopilot tools](https://adcopilot.cloud/docs/llms.mdx/docs/tools/adcopilot.md): get_org_context, the call every conversation starts with, and save_org_context, which remembers your business between conversations. Neither counts against your daily operations.
  - [Read and report tools](https://adcopilot.cloud/docs/llms.mdx/docs/tools/read.md): The Google Ads reading tools — search over every reportable resource, account discovery, schema lookups, asset links and auto-apply subscriptions. None of them changes anything.
  - [Analysis and audit tools](https://adcopilot.cloud/docs/llms.mdx/docs/tools/analysis.md): AdCopilot's eleven read-only analysis tools as of v2.16.0 — full_audit, account_health_score and nine focused lenses. They do the arithmetic on AdCopilot's side and quote the numbers they measured.
  - [Campaign tools](https://adcopilot.cloud/docs/llms.mdx/docs/tools/campaigns.md): Create Search and Performance Max campaigns with a budget, change budgets, networks and bidding, and pause or re-enable campaigns. Every write is proposed first and checked against your saved budget.
  - [Ad group and ad tools](https://adcopilot.cloud/docs/llms.mdx/docs/tools/ad-groups.md): Structure below the campaign — ad groups, responsive search ads, and ad status. All writes, each proposed first.
  - [Keyword and negative tools](https://adcopilot.cloud/docs/llms.mdx/docs/tools/ads-keywords.md): Add keywords, change their bids and status, and block off-intent searches with negatives — on one campaign, in a shared list, or across the account. A negative can be added here but not removed.
  - [Targeting and bid tools](https://adcopilot.cloud/docs/llms.mdx/docs/tools/targeting.md): Where, when and on which devices your ads compete — locations, ad schedule and device bid adjustments. All writes, each proposed first.
  - [Asset tools](https://adcopilot.cloud/docs/llms.mdx/docs/tools/assets.md): Sitelinks, callouts, calls, images, promotions, prices, lead forms and more — create them, link them at campaign, ad group or account level, and pause or re-enable a link. All writes, each proposed first.
  - [Performance Max](https://adcopilot.cloud/docs/llms.mdx/docs/tools/performance-max.md): How AdCopilot builds a Performance Max campaign — the campaign with a business name and logo, then an asset group holding the text, image and video that feed it.
  - [Conversions and auto-apply](https://adcopilot.cloud/docs/llms.mdx/docs/tools/conversions.md): Create a Google Ads conversion action and get the ID and label its tag needs, and pause the recommendation types Google applies to your account without asking.
  - [Google Analytics tools](https://adcopilot.cloud/docs/llms.mdx/docs/tools/google-analytics.md): The 23 Google Analytics tools as of v2.16.0 — 11 reads (reports, realtime, funnels, and your properties' setup) and 12 writes (conversions, custom definitions, data streams, properties, and the link to Google Ads). None deletes.
  - [Search Console tools](https://adcopilot.cloud/docs/llms.mdx/docs/tools/search-console.md): The 6 Search Console tools as of v2.16.0 — 4 reads (search performance, sites, sitemaps, URL inspection) and 2 writes (submit a sitemap, request indexing). None deletes.
  - [Tag Manager tools](https://adcopilot.cloud/docs/llms.mdx/docs/tools/tag-manager.md): The 18 Tag Manager tools as of v2.16.0 — 9 reads and 9 writes. Every change is staged in AdCopilot's own workspace in your container and never published; you publish. Nothing is deleted.
- Checks
  - [Conversion tracking](https://adcopilot.cloud/docs/llms.mdx/docs/checks/conversion_tracking.md): The 11 scored AdCopilot checks in the conversion tracking category, with the analysis tools that surface each.
  - [Wasted spend](https://adcopilot.cloud/docs/llms.mdx/docs/checks/wasted_spend.md): The 8 scored AdCopilot checks and 7 observations in the wasted spend category, with the analysis tools that surface each.
  - [Account structure](https://adcopilot.cloud/docs/llms.mdx/docs/checks/structure.md): The 12 scored AdCopilot checks in the account structure category, with the analysis tools that surface each.
  - [Keywords and Quality Score](https://adcopilot.cloud/docs/llms.mdx/docs/checks/keywords_qs.md): The 8 scored AdCopilot checks and 3 observations in the keywords and quality score category, with the analysis tools that surface each.
  - [Ads and assets](https://adcopilot.cloud/docs/llms.mdx/docs/checks/ads_assets.md): The 16 scored AdCopilot checks and 1 observation in the ads and assets category, with the analysis tools that surface each.
  - [Settings and targeting](https://adcopilot.cloud/docs/llms.mdx/docs/checks/settings_targeting.md): The 18 scored AdCopilot checks and 5 observations in the settings and targeting category, with the analysis tools that surface each.
- Troubleshooting
  - [Troubleshooting](https://adcopilot.cloud/docs/llms.mdx/docs/troubleshooting.md): Find the fix for what you are seeing — connecting Claude or ChatGPT, a missing or out-of-date tool, a partial audit, a budget refusal or warning, a plan cap, a Google product that is not connected, a missing account, reconnecting, and billing.
  - [Connecting Claude](https://adcopilot.cloud/docs/llms.mdx/docs/troubleshooting/connect-claude.md): Fixes for connecting AdCopilot to Claude — Claude asking permission before every report, Chrome's autofill covering the URL box, no Customize in the sidebar, and custom connectors in a Team or Enterprise organisation.
  - [Connecting ChatGPT](https://adcopilot.cloud/docs/llms.mdx/docs/troubleshooting/connect-chatgpt.md): Fixes for connecting AdCopilot to ChatGPT — no developer mode switch, "No app tools available yet", ChatGPT searching the web instead of using AdCopilot, and the sign-in tab that keeps spinning.
  - [A tool is missing or out of date](https://adcopilot.cloud/docs/llms.mdx/docs/troubleshooting/tool-missing.md): Your assistant keeps the tool list from when it connected. How to tell when it is stale — the "Tools revision" stamp and get_org_context(tools=[…]) — how to reconnect so it picks up new tools, and what a Google product you just connected needs.
  - [An audit returned partial results](https://adcopilot.cloud/docs/llms.mdx/docs/troubleshooting/audit-partial.md): Why a full_audit lists checks as not evaluated, what it means when it reached its time limit or timed out, and how to get a complete run.
  - [Budget refusals and warnings](https://adcopilot.cloud/docs/llms.mdx/docs/troubleshooting/money-fence.md): What each of AdCopilot's budget messages means — the comfortable-daily-budget warning, the monthly-cap refusal, Maximize Clicks with no cap, no budget saved, and the campaign it built — and what to do.
  - [Plan caps and limits](https://adcopilot.cloud/docs/llms.mdx/docs/troubleshooting/plan-caps.md): What happens at the daily operations cap or the account limit — nothing is deleted, calls are refused until the reset, a switched-off account, or an upgrade — and the grace day on Starter and Plus.
  - [A Google product is not connected](https://adcopilot.cloud/docs/llms.mdx/docs/troubleshooting/google-product-access.md): When AdCopilot says Analytics, Search Console, Tag Manager or Google Ads isn't connected, isn't available through your assistant's authorisation, is read-only, or Google revoked its access — what each means and the fix.
  - [Account not showing up](https://adcopilot.cloud/docs/llms.mdx/docs/troubleshooting/account-not-showing.md): A Google Ads account you expect is missing, switched off, or refused. The usual causes and fixes, in order.
  - [Reconnect troubleshooting](https://adcopilot.cloud/docs/llms.mdx/docs/troubleshooting/reconnect.md): AdCopilot says Google is no longer accepting its sign-in, or a Google sign-in did not restore access. What to check and how to fix it.
  - [Billing and payment issues](https://adcopilot.cloud/docs/llms.mdx/docs/troubleshooting/billing-payment.md): A payment did not go through, a plan change did not apply, or the workspace became read-only or inactive. Where to look and what each state means.