get_ad_group

Get all the stored fields of one ad group — a Meta ad set, a TikTok ad group or a Google Ads ad group.

Ask for all the settings of one ad set or ad group. The agent reads the fields that AdCrunch stored from the provider for it.

Show me all the settings of the “Women 25-44, France” ad set.

The agent reads the stored fields of that ad set. You see each field in the words of the provider, such as its campaign, and a Meta budget in whole units of the currency of the ad account. Read your accounts shows the full job.

Reference

Available on:

Get all the stored fields of one ad group — a Meta ad set, a TikTok ad group or a Google Ads ad group — by its ad account and its id. AdCrunch converts the Meta fields daily_budget, lifetime_budget and bid_amount to whole units of the account currency (50 is 50.00). This is the unit of budget in the list tools. When AdCrunch does not know the account currency, these Meta fields are null. A field whose name ends in Micros stays in micros (12340000 is 12.34). Every other field has the value that the provider sent. It sends the payload that AdCrunch stored from the provider at the last ingestion, with the field names of the provider. Use it when a row of list_ad_groups does not hold the field that you need. To read the row of the provider now, use meta_list_adsets, tiktok_list_adgroups or gads_list_ad_groups with ids set to the id. An ad account that your organization does not own, an id that AdCrunch does not store for that ad account, and a provider that has no ad groups each give not_found.

Input

Argument	Type	Required	Description
`advertiserId`	string	yes	The ad account that holds the ad group, prefixed `acc_`. It must belong to your organization. Each row of list_ad_groups gives it as `advertiserId`.
`id`	string	yes	The id that the provider gives the ad group, with no prefix. Each row of list_ad_groups gives it as `id`.

Output

A successful call returns this object in structuredContent.

Field	Type	Always present	Description
`adGroup`	map of any	yes	The payload that AdCrunch stored from the provider for the ad group. The keys are the keys of the provider, and they differ for each provider: a Meta ad set has `campaign_id` and its budget fields, and a TikTok ad group has `adgroup_id`, `budget_mode` and `optimization_goal`.

Failure codes

A failed call has isError set, and structuredContent.error holds one of these codes. Errors describes the shape of a failed call.

not_found
payload_unavailable
forbidden
invalid_request
internal_error

Scope

The token must hold observe:read. Auth & scopes lists each scope.

Annotations

A client reads these hints. A hint that the tool does not declare has the default value of the MCP specification.

Read-only. The tool changes nothing.
Closed world. The tool reads and writes the data of AdCrunch only.

Example

The arguments:

{
  "advertiserId": "acc_1203456789012345",
  "id": "120210000000001"
}

The result, in structuredContent:

{
  "adGroup": {
    "account_id": "1203456789012345",
    "campaign_id": "120210000000000",
    "created_time": "2026-09-16T23:06:40+0000",
    "id": "120210000000001",
    "name": "Women 25-44, France",
    "status": "ACTIVE",
    "updated_time": "2026-09-20T10:26:40+0000"
  }
}