Skip to content

meta_search_locations

Find Meta targeting keys: places with type adgeolocation (countries, regions, cities, zips, for geo_locations) or languages with type adlocale (keys…

View as Markdown

Find Meta targeting keys: places with type adgeolocation (countries, regions, cities, zips, for geo_locations) or languages with type adlocale (keys for locales). Up to 50 searches in one call, each answered with Meta's own rows (key, name, type, country_code, region...). Read-only.

Source
Meta Ads
Kind
Read
Discovery
Reachable through search_tools and run_tool
Account parameter
adAccountId
Endpoint
https://mcp.getmcpads.com/meta-ads/mcp

Parameters

Parameters
NameTypeRequiredNotes
adAccountIdstringRequiredOwning advertising account ID. Use the exact ID returned by account discovery; do not substitute a campaign or business ID.
typestringRequiredadgeolocation for places, adlocale for languages. One of: adgeolocation, adlocale.
queriesarrayRequiredNames or codes to search (Paris, Île-de-France, 75011, French), one Graph search each.
locationTypesarrayOptionaladgeolocation only: the kinds of place returned.
countryCodestringOptionaladgeolocation only: ISO country the places are searched in.
limitintegerOptionalRows per search, 25 by default.

Calling it

json · Through run_tool, since it is not announced
{
  "name": "run_tool",
  "arguments": {
    "name": "meta_search_locations",
    "args": {
      "adAccountId": "<string>",
      "type": "adgeolocation",
      "queries": "<array>"
    }
  }
}

Manage your ads from your AI assistant

Start for free

Free with 1 ad account, no card. Pro is free for 7 days.

Esc

Type to search