get_ad

Get all the stored fields of one ad at Meta, TikTok or Google Ads.

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

Show me all the settings of the “Carousel — bestsellers” ad.

The agent reads the stored fields of that ad. You see each field in the words of the provider. On Meta, the fields name the creative of the ad. On TikTok, they hold the video or the images and the call to action. Read your accounts shows the full job.

Reference

Available on:

Get all the stored fields of one ad at Meta, TikTok or Google Ads, by its ad account and its id. A Google Ads id has the form {adGroupId}~{adId}, as list_ads gives it. 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_ads does not hold the field that you need. To read the row of the provider now, use meta_list_ads, tiktok_list_ads or gads_list_ad_group_ads 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 ads each give not_found.

Input

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

Output

A successful call returns this object in structuredContent.

Field	Type	Always present	Description
`ad`	map of any	yes	The payload that AdCrunch stored from the provider for the ad. The keys are the keys of the provider, and they differ for each provider: a Meta ad has `adset_id` and the id of its `creative`, and a TikTok ad holds its creative material, such as `video_id`, `image_ids` and `call_to_action`.

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": "120210000000002"
}

The result, in structuredContent:

{
  "ad": {
    "account_id": "1203456789012345",
    "adset_id": "120210000000001",
    "campaign_id": "120210000000000",
    "created_time": "2026-09-16T23:06:40+0000",
    "creative": {
      "id": "120210000000003"
    },
    "id": "120210000000002",
    "name": "Carousel — bestsellers",
    "status": "ACTIVE",
    "updated_time": "2026-09-20T10:26:40+0000"
  }
}