List Google conversion actions (`adsap_google_list_conversion_actions`)

Platform: Google Ads · Read or write: Read · Plan: All plans · Consumes a task: No · Preview supported: No

What it does

Lists the conversion actions in a Google Ads account: name, type, category, status, whether it is primary for a goal, and how it counts. Check it before you create a campaign that bids on conversions. It is also the first stop when conversions stop tracking.

When to use it

Use it before you create a campaign that bids on conversions, to confirm an enabled primary conversion action exists.
Use it when conversions are missing, to check each action’s status and primary_for_goal flag.
It reads the conversion setup live from Google, with the 10-digit customer ID from adsap_google_list_ad_accounts.
Removed actions are hidden unless you pass include_removed as true.
It lists the setup, not the numbers. For conversion counts per action, use adsap_google_get_conversion_breakdown.

Worked example

You ask

“Before I launch a Maximize Conversions campaign, what conversion actions are set up in Google Ads account 1234567890?”

The assistant calls `adsap_google_list_conversion_actions`


{
  "ad_account_id": "1234567890"
}

Adsap returns

The field names are the ones Adsap returns. The values are examples.


{
  "ok": true,
  "data": [
    {
      "id": "7000000001",
      "name": "Purchase",
      "type": "WEBPAGE",
      "category": "PURCHASE",
      "status": "ENABLED",
      "primary_for_goal": true,
      "counting_type": "MANY_PER_CLICK",
      "origin": "WEBSITE"
    },
    {
      "id": "7000000002",
      "name": "Newsletter sign-up",
      "type": "WEBPAGE",
      "category": "SIGNUP",
      "status": "ENABLED",
      "primary_for_goal": false,
      "counting_type": "ONE_PER_CLICK",
      "origin": "WEBSITE"
    }
  ],
  "meta": {
    "total_count": 2,
    "enabled_primary_count": 1,
    "note": "primary_for_goal actions count toward the Conversions metric and drive bidding; secondary ones only appear in All conversions."
  }
}

How to read it

meta.enabled_primary_count is the number of actions that are both ENABLED and primary_for_goal. Here it is 1, the purchase action, so conversion bidding has something to optimize toward. The sign-up action is secondary. It shows up in all conversions only and does not steer bidding.

When the count is 0, meta.note warns that Maximize Conversions and target CPA bidding will struggle or fail. Set up conversion tracking in Google Ads before you launch. counting_type tells you whether Google counts one conversion or many per click.

Parameters

Descriptions are shortened from the tool schema. Your assistant sees the full text.

Name	Type	Required	Description
`ad_account_id`	string	Yes	Bare 10-digit Google Ads customer ID (from adsap_google_list_ad_accounts). No dashes, no act_ prefix.
`include_removed`	boolean	No	Also list REMOVED conversion actions (default false).

Example prompts

“What conversion actions are set up in my Google Ads account?”
“Do I have a primary purchase conversion enabled before I launch a Maximize Conversions campaign?”
“Why are my Google conversions not tracking?”

Notes

Maximize Conversions and target CPA need at least one enabled primary conversion action. Target ROAS also needs conversion value history.

adsap_google_get_conversion_breakdown: Break a Google Ads account’s conversions down BY CONVERSION ACTION (Purchase vs Lead vs Sign-up vs phone call…) instead of one lumped…

Guide

Read Insights and reporting for the workflow around this tool, and the Tool reference for every tool.

The Google Ads MCP server page shows how to connect Google Ads to Claude, ChatGPT or Perplexity.

List Google conversion actions (adsap_google_list_conversion_actions)