Google Ads with AdKit

This skill tells you how to create, edit, and report on Google Ads through AdKit. It covers the steps. For what to build (keywords, structure, ad copy), read the google-ads-strategy skill.

Connect AdKit

AdKit is one MCP connector for Meta, Google, TikTok, LinkedIn, Microsoft, Reddit, X, and Pinterest ads.

• Claude, ChatGPT, and most AI apps: add a custom connector with the address https://mcp.adkit.so, then sign in.
• Claude Code: claude mcp add --transport http adkit https://mcp.adkit.so

For other AI apps, see how to set up the AdKit MCP server for Google Ads. If the AdKit tools are not available, tell the user how to connect. Then stop.

What AdKit can do on Google Ads

Steps

All calls go through adkit_manage with platform: "google". Before a call you have not made in this session, read its fields with adkit_help({ path: "manage google <entity> <action>" }). Do not guess field names. In this skill, campaigns create means entity: "campaigns", action: "create".

1. Project: call adkit_projects and get the projectId. Every call needs it.
2. Account: call adkit_status. If no Google Ads account is connected, call adkit_setup with platform: "google" and give the user the link. After they sign in, use accounts available, then accounts connect.

3. Build from the top down. Each create saves a draft. For each level, do these steps before you start the next level:

   • Show the draft to the user (drafts get, or the link https://app.adkit.so/manage/drafts?open=<draftId>).
   • Wait for a yes. Then publish it with drafts publish.
   • Use the Google ID that the publish result returns as the parent of the next level. A draft ID never works as a parent ID.

   The levels, in order, for a Search campaign:

   1. Keyword research: research keywords for ideas. Choose keywords and match types with the user.
   2. Campaign: campaigns create with campaignType: "search", a budget, a bid strategy, locations (geo-locations search finds cities and regions by name), and status: "paused". A paused campaign spends nothing.
   3. Ad group: ad-groups create with the campaignId.
   4. Keywords and ad: keywords create and ads create (responsive search ad) with the adGroupId.
   5. Negative keywords and assets: keywords add-negative, then sitelinks and callouts with assets create and assets attach.
4. Go live: campaigns update with status: "enabled". Publish that draft only after the user says yes. Then check with ad-groups list and ads list that the ad groups and ads are enabled too.
5. Results: results list with a level and a period or a date range (from and to). For Search, results search-terms shows what people typed. Use it to suggest new keywords and negatives.

Google Ads rules

• Performance Max: create the campaign with its assetGroups. It has asset groups instead of ad groups and ads. Upload the images first.
• Display (beta): upload images, set targeting on the ad group, then create a responsive_display ad. A targeting update replaces the whole list, so send every item that should stay.
• Demand Gen video: register a video that is already on YouTube with media upload. AdKit cannot upload a video file to YouTube.
• Manager accounts (MCC): connecting an account under a manager also needs the managerId.
• Ads: updating or deleting an ad needs its adGroupId.
• Conversions: keep the account's existing conversion goals unless the user asks for a change. conversions upload (offline imports) runs immediately and saves no draft. First run it with validateOnly: true. Then ask the user. Run the real upload only after they say yes.
• Before you retry a failed write, read change-history so you do not create the same thing twice.
• List actions return settings only. Spend, clicks, conversions, and Quality Score come from results.
• Use AdKit field names (camelCase). The entities in the table above ignore raw Google Ads API field names.

Anything else in the Google Ads API

For a Google Ads feature that AdKit does not cover (for example dynamic search ad targets or page feeds), use entity: "platform-api-request" with action: "mutate". The action is always mutate, also for reads. AdKit sends the request to the Google Ads API as it is. The user must turn on Advanced Platform Access in AdKit's Agent Permissions.

• Check every resource and field in the Google Ads API reference.
• Read requests run immediately, with no draft. Writes save a draft, like any other change.
• After you use it, report the missing feature with adkit_feedback.

{
  "projectId": "<projectId>",
  "entity": "platform-api-request",
  "action": "mutate",
  "data": {
    "platform": "google",
    "accountId": "<customerId>",
    "endpoint": "customers/<customerId>/googleAds:mutate",
    "payload": {
      "mutateOperations": [
        {
          "adGroupAdOperation": {
            "update": {
              "resource_name": "customers/<customerId>/adGroupAds/<adGroupId>~<adId>",
              "status": "PAUSED"
            },
            "update_mask": "status"
          }
        }
      ]
    },
    "description": "Pause one ad"
  }
}

Other platforms

The same AdKit connector runs Meta Ads, TikTok Ads, LinkedIn Ads, Microsoft Ads, Reddit Ads, X Ads, and Pinterest Ads ads. Each platform has its own skill in this repo, for example meta-ads and microsoft-ads.