get_campaign

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

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

Show me all the settings of the Spring sale campaign.

The agent reads the stored fields of that campaign. You see each field in the words of the provider, such as the start time of the 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 campaign at Meta, TikTok or Google Ads, by its ad account and its id. A campaign here is the object at the provider, not a Campaign Plan: for those, use campaign_plan_list. 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_campaigns does not hold the field that you need. To read the row of the provider now, use meta_list_campaigns, tiktok_list_campaigns or gads_list_campaigns 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 campaigns each give not_found.

Input

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

Output

A successful call returns this object in structuredContent.

Field	Type	Always present	Description
`campaign`	map of any	yes	The payload that AdCrunch stored from the provider for the campaign. The keys are the keys of the provider, and they differ for each provider: a Meta campaign has `objective`, `daily_budget` and `start_time`, and a TikTok campaign has `campaign_id`, `campaign_name` and `objective_type`.

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

The result, in structuredContent:

{
  "campaign": {
    "account_id": "1203456789012345",
    "created_time": "2026-09-16T23:06:40+0000",
    "daily_budget": 250,
    "id": "120210000000000",
    "name": "Spring sale — prospecting",
    "objective": "OUTCOME_SALES",
    "start_time": "2026-09-17T00:00:00+0000",
    "status": "ACTIVE",
    "updated_time": "2026-09-20T10:26:40+0000"
  }
}