Search Google Ads geo targets (`adsap_google_search_geo_targets`)

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

What it does

Resolves location names (cities, regions, countries, postal areas) to Google Ads geo target IDs. Each match returns its ID, type, country, reach and parent locations. The IDs feed campaign location targeting.

When to use it

Use it before any Google call that targets or excludes a location. Those calls take numeric IDs, not names.
It needs no ad_account_id, because Google’s location lookup is not tied to an account. Your own Google connection is still required.
One call resolves up to 25 location_names. Add a 2-letter country_code when a name exists in several countries.
The id values go into geo.location_ids of adsap_google_create_search_campaign, geo_targets of adsap_google_manage_targeting, or geo_target_ids of adsap_google_keyword_ideas.
For Meta locations, use adsap_search_geo_locations.

Worked example

You ask

“What is the Google Ads location ID for France? I want to target the whole country.”

The assistant calls `adsap_google_search_geo_targets`


{
  "location_names": ["France"],
  "country_code": "FR"
}

Adsap returns

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


{
  "ok": true,
  "data": [
    {
      "id": "2250",
      "name": "France",
      "canonical_name": "France",
      "target_type": "Country",
      "country_code": "FR",
      "status": "ENABLED",
      "reach": 58400000,
      "search_term": "France",
      "parents": []
    }
  ],
  "meta": {
    "total_count": 1,
    "note": "Pass the `id` values into geo.location_ids (or geo.negative_location_ids) of adsap_google_create_search_campaign."
  }
}

How to read it

id is the value the targeting tools expect, as a string of digits. target_type says what kind of place matched, and parents lists the larger places that contain it. The list is empty when Google returns no parent. search_term is the name you sent that produced the match, which helps when you resolve several names at once.

reach is Google’s reach figure for the location. When two matches share a name, compare canonical_name, country_code and parents to pick the right one.

Parameters

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

Name	Type	Required	Description
`location_names`	array of string	Yes	Location names to resolve, e.g. [‘Paris’, ‘Lyon’]. Max 25 per call.
`country_code`	string	No	Optional 2-letter ISO country code to scope the search: recommended for ambiguous city names.
`locale`	string	No	Display-language locale for the returned names (default ‘en’).

Example prompts

“Find the Google geo targets for Paris, Lyon and Marseille in France.”
“What is the location ID for Austin, Texas in Google Ads?”

Notes

You can resolve up to 25 names per call. Pass a country code for ambiguous names, such as Paris in France versus Paris in Texas.

adsap_google_keyword_ideas: Get keyword suggestions with search volume from Google Keyword Planner for a Google Search campaign.
adsap_google_manage_keywords: Manage Google Ads Search keywords AFTER creation.
adsap_google_manage_targeting: Manage a Google Ads campaign or ad group’s targeting AFTER creation: GEO, LANGUAGE and AUDIENCES.
adsap_google_search_terms: Search terms report for a Google Ads account: the REAL user queries that triggered Search (and Shopping) ads, with…

Guide

Read Google Ads 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.

Search Google Ads geo targets (adsap_google_search_geo_targets)