AdPilot
UKRUENStart for free
AdPilot
LanguageUKRUEN
Documentation

AdPilot MCP server

Connect your Google Ads account to Claude or ChatGPT through AdPilot.

Server URL
https://app.adpilot.com.ua/api/mcp

01What it is

AdPilot connects your Google Ads account to Claude and ChatGPT. Once connected, you can ask your assistant in plain language about your ads — spend, conversions, search terms, recommendations, what changed — and have it make any change AdPilot's cabinet chat can make — from negative keywords, budgets and bids to ads, keywords, assets and removals — or undo a previous change.

The assistant works only when you ask. Every change is shown to you first and is recorded in your AdPilot change history.

You can connect Claude, ChatGPT, Cursor, VS Code/GitHub Copilot, Gemini CLI or another MCP client that supports remote servers with OAuth sign-in, using the server URL above.

02Requirements

  • An AdPilot account. Sign up at app.adpilot.com.ua/register; the account starts with a free 3-day trial.
  • A Google Ads account connected to AdPilot (done once in the AdPilot cabinet).
  • The free 3-day trial or an active subscription to any AdPilot plan: AdPilot MCP Tools (₴2,000 per month for 1 Google Ads account; built for using AdPilot from your own assistant), AdPilot or AdPilot + Autopilot. Current prices are on adpilot.com.ua/en/#pricing. Prices are in Ukrainian hryvnia; international pricing and payment options are being prepared.
  • A Claude or ChatGPT account that can add a remote MCP connector (see the sections below for plan notes), or another MCP client that supports remote servers with OAuth sign-in.

If your AdPilot subscription lapses, your workspace becomes view-only: changes are disabled and new connections cannot be approved until you renew.

03Connect in Claude

From the Connectors Directory (once AdPilot is listed)

  1. In Claude, open Customize > Connectors.
  2. Find AdPilot and click to connect.
  3. Sign in to AdPilot when the sign-in window opens.
  4. On the screen "Allow “Claude” to access AdPilot?" click Allow.

As a custom connector (works today)

  1. In Claude, open Customize > Connectors and click Add custom connector. On Team and Enterprise plans an Owner adds it under Organization settings > Connectors (Add, then Custom), and each member then clicks Connect on it.
  2. Enter the server URL: https://app.adpilot.com.ua/api/mcp
  3. If Claude asks how it should identify itself to the server (OAuth client), choose Register automatically. Leave other settings at their defaults.
  4. Click Add, then sign in to AdPilot with your email and password (or Google) when the sign-in window opens.
  5. On the consent screen, review what Claude will get access to and click Allow. Choose Deny to cancel.
  6. Open a new chat, click +, choose Connectors, and make sure AdPilot is turned on. Then ask, for example: "Review my Google Ads account for the last 7 days through AdPilot. Where is spend wasted? Show me any change before applying it."

Custom connectors can be added on Free (one connector), Pro, Max, Team and Enterprise plans.

Claude Code

Terminal
claude mcp add --transport http adpilot https://app.adpilot.com.ua/api/mcp

Then run /mcp and choose Authenticate.

04Connect in ChatGPT

  1. In ChatGPT on the web, open Plugins (chatgpt.com/plugins), click the plus button and choose Add custom MCP server.
  2. Enter the name AdPilot and, under Connection, the server URL: https://app.adpilot.com.ua/api/mcp
  3. For authentication choose OAuth. Leave the client credentials empty so ChatGPT registers itself automatically.
  4. Read the risk notice, select I understand and want to continue, then Create as a plugin.
  5. ChatGPT opens the AdPilot sign-in. Sign in and click Allow on the consent screen.
  6. Install the plugin if prompted, start a new chat, select AdPilot, and ask your question.

Custom MCP servers are limited to certain ChatGPT plans and workspaces. Workspace administrators may restrict adding custom servers.

05Tools

AdPilot provides 15 tools; together they cover everything AdPilot's cabinet chat can do. Each tool works on your own workspace only; you never enter a customer ID — the account is determined by your sign-in.

Read-only tools (do not change anything)

ToolTitleWhat it does
list_accountsList accountsLists the Google Ads accounts connected to your AdPilot workspace.
get_account_overviewGet account overviewLatest daily metrics, 30-day totals of cost and conversions, and the number of open issues for one account.
get_metricsGet metricsDaily cost, conversions, conversion value, ROAS, CTR and CPA for a period (up to 180 days).
get_search_termsGet search termsSearch terms that triggered your Search ads in the last 1–90 days, with clicks, cost and conversions (up to 60 rows). Reads live from Google Ads.
get_recommendationsGet recommendationsOpen AdPilot recommendations for the account from the last 30 days, with priority and estimated impact.
get_change_historyGet change historyChanges made to the account through AdPilot (manual, autopilot, chat, assistant) for the last 1–90 days, 25 per page (up to 50), with an ID you can use to roll a change back.
run_gaqlRun GAQL queryRuns one read-only Google Ads report query (GAQL) for the account — campaigns, ad groups, ads, keywords, conversions — and returns up to 100 rows.
list_actionsList actionsFinds an action in AdPilot's catalog: about 140 Google Ads changes — keywords, negative lists, ads, assets, audiences, labels, bidding, locations, schedules, conversions, products — and reports from Google Analytics 4, Merchant Center, Search Console, bid and budget simulations, Quality Score and ad strength, with the parameters each one takes.

Tools that change your ads

ToolTitleWhat it does
add_negative_keywordsAdd negative keywordsAdds up to 20 negative keywords to one campaign (match type EXACT, PHRASE or BROAD).
pause_campaignPause campaignPauses one campaign.
enable_campaignEnable campaignRe-enables a paused campaign.
set_campaign_budgetSet campaign budgetChanges a campaign's daily budget.
rollback_changeRoll back changeUndoes a previous AdPilot change, where that type of change can be reversed.
google_ads_mutateGoogle Ads changeMakes any other Google Ads change in one request — create, update or remove campaigns, ad groups, ads, keywords, assets and settings. Removals cannot be undone; the preview says so.
run_actionRun actionRuns one action found with list_actions, through the same checks as AdPilot's chat. A report runs at once; a change previews first, and a removal that cannot be undone is marked as such.

How changes are made. Every tool that changes your ads takes a confirm setting that is off by default.

  • With confirm off, the tool only returns a preview of what would happen. Nothing is changed in Google Ads.
  • The change is made when the assistant calls the tool with confirm on. AdPilot asks for no further confirmation and shows no approval card in the cabinet: whether the assistant checks with you first is up to you and the assistant.
  • A removal that cannot be undone is marked as such in the preview.
  • There is no daily limit on changes. To protect the server, one workspace can make up to 120 tool calls per minute.
  • AdPilot still applies two rules: if a monthly spend limit is set in AdPilot (Settings → How AdPilot works → Monthly spend limit), a budget increase that would take projected monthly spend (daily budgets × 30.4) above it is refused; and billing, account access and users are never changed.
  • Claude and ChatGPT can ask for your approval before running a tool that changes data, depending on their settings. In Claude you can set a tool to Blocked under Customize > Connectors if you never want it used.

Every applied change is saved to your AdPilot change history. You can review it, and roll it back from the cabinet or with rollback_change. Not every kind of change can be reversed — for example, a rollback preview tells you whether a change is reversible before you confirm it.

When the trial has ended without a paid plan, or the subscription is not active, every tool replies that access is not included, and nothing is read or changed.

06Permissions and revoking access

What the assistant can access. When you click Allow on AdPilot's consent screen, the assistant gets access to your AdPilot workspace through the 15 tools above: reading your account data and the Google services connected to AdPilot (Google Ads, Google Analytics 4, Merchant Center, Search Console), and making any change you ask for, including removals, with no confirmation step in AdPilot. It does not receive your password, payment details or your Google credentials, and it cannot reach other AdPilot customers' data.

Access is granted for the whole workspace as one permission (adpilot). There is no per-tool or per-account scope on AdPilot's side. The Google Ads data AdPilot reads is described in the Privacy Policy.

How long access lasts. Access tokens expire after 1 hour and are renewed automatically with a refresh token that is valid for 30 days and is replaced each time it is used. Tokens are stored as hashes on AdPilot's side.

How to revoke access

  • In AdPilot: open Settings → Your agent in the cabinet and click Disconnect next to the connected assistant. The assistant loses access immediately. You can reconnect at any time.
  • In Claude: Customize > Connectors, select AdPilot and click Remove.
  • In ChatGPT: open the AdPilot plugin's settings and remove it.

Removing the connector in Claude or ChatGPT stops the assistant from calling AdPilot; disconnecting in AdPilot also ends the tokens that were issued. Do both if you want to be sure.

07Privacy

The assistant receives only what a tool returns when it is called: for example, your daily metrics, search terms, recommendations or the result of a change. AdPilot does not push data to the assistant on its own. What your assistant (Claude, ChatGPT or another MCP client) does with a conversation is governed by its provider's own privacy terms and settings.

How AdPilot processes data — what we collect, why, who receives it, where it is stored and for how long — is set out in the AdPilot Privacy Policy. The Public Offer contains the service terms. For data retention and deletion, see sections 3, 8 and 11 of the Privacy Policy; to request deletion, write to inbox@adpilot.com.ua.

08Support

Email inbox@adpilot.com.ua.

09FAQ

Do I need a separate Claude or ChatGPT plan?
You need a Claude or ChatGPT account that can add a remote connector. In Claude, custom connectors can be added on Free (one connector), Pro, Max, Team and Enterprise plans. For ChatGPT see the note in section 4. You also need an AdPilot account.
Can the assistant change my ads without asking?
AdPilot does not ask you separately: when the assistant calls a change tool with confirmation on, the change is made. Whether the assistant checks with you first depends on your instructions and its settings — in Claude you can require approval for a tool or block it. A removal that cannot be undone is marked in the preview, a monthly spend limit set in AdPilot still applies, and every change is logged in your AdPilot change history.
Can I undo a change?
Yes, in most cases. Ask your assistant to roll back a change (it finds the change in your change history), or roll it back in the AdPilot cabinet. Some types of change cannot be reversed; AdPilot tells you before you confirm.
Does the assistant see my other Google Ads accounts?
Only the active Google Ads accounts connected to your AdPilot workspace, within your plan's account limit: one on the trial, AdPilot MCP Tools and AdPilot; up to three on AdPilot + Autopilot, more with extra seats.
How do I stop the connection?
Click Disconnect on the Your agent card in AdPilot, or remove the connector in Claude or ChatGPT. See section 6.
Don’t have AdPilot yet?3 days free, then pick a plan.
Start for free