AdPilot MCP server
Connect your Google Ads account to Claude or ChatGPT through AdPilot.
https://app.adpilot.com.ua/api/mcp01What 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)
- In Claude, open Customize > Connectors.
- Find AdPilot and click to connect.
- Sign in to AdPilot when the sign-in window opens.
- On the screen "Allow “Claude” to access AdPilot?" click Allow.
As a custom connector (works today)
- 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.
- Enter the server URL:
https://app.adpilot.com.ua/api/mcp - If Claude asks how it should identify itself to the server (OAuth client), choose Register automatically. Leave other settings at their defaults.
- Click Add, then sign in to AdPilot with your email and password (or Google) when the sign-in window opens.
- On the consent screen, review what Claude will get access to and click Allow. Choose Deny to cancel.
- 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
claude mcp add --transport http adpilot https://app.adpilot.com.ua/api/mcpThen run /mcp and choose Authenticate.
04Connect in ChatGPT
- In ChatGPT on the web, open Plugins (chatgpt.com/plugins), click the plus button and choose Add custom MCP server.
- Enter the name
AdPilotand, under Connection, the server URL:https://app.adpilot.com.ua/api/mcp - For authentication choose OAuth. Leave the client credentials empty so ChatGPT registers itself automatically.
- Read the risk notice, select I understand and want to continue, then Create as a plugin.
- ChatGPT opens the AdPilot sign-in. Sign in and click Allow on the consent screen.
- 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)
| Tool | Title | What it does |
|---|---|---|
list_ | List accounts | Lists the Google Ads accounts connected to your AdPilot workspace. |
get_ | Get account overview | Latest daily metrics, 30-day totals of cost and conversions, and the number of open issues for one account. |
get_ | Get metrics | Daily cost, conversions, conversion value, ROAS, CTR and CPA for a period (up to 180 days). |
get_ | Get search terms | Search 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_ | Get recommendations | Open AdPilot recommendations for the account from the last 30 days, with priority and estimated impact. |
get_ | Get change history | Changes 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_ | Run GAQL query | Runs one read-only Google Ads report query (GAQL) for the account — campaigns, ad groups, ads, keywords, conversions — and returns up to 100 rows. |
list_ | List actions | Finds 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
| Tool | Title | What it does |
|---|---|---|
add_ | Add negative keywords | Adds up to 20 negative keywords to one campaign (match type EXACT, PHRASE or BROAD). |
pause_ | Pause campaign | Pauses one campaign. |
enable_ | Enable campaign | Re-enables a paused campaign. |
set_ | Set campaign budget | Changes a campaign's daily budget. |
rollback_ | Roll back change | Undoes a previous AdPilot change, where that type of change can be reversed. |
google_ | Google Ads change | Makes 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_ | Run action | Runs one action found with list_, 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
confirmoff, 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
confirmon. 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.