meta_list_creatives

Read the ad creatives of one Meta ad account from Meta now.

Ask which creatives a Meta ad account holds before you build an ad. The agent asks Meta, so a creative that someone made a minute ago is in the answer. An ad can use a creative that already runs in another ad.

Which creatives does the Northwind account have?

The agent calls meta_list_creatives with the Northwind advertiser. You see the name and the id of each creative. Change what runs on Meta shows how an ad uses a creative.

Reference

Available on:

Meta: list the ad creatives of one ad account, as Meta holds them now. Each call asks Meta now, and it counts against the rate limits of Meta. AdCrunch stores nothing from this read. To read one, send its id in ids. createdAt, updatedAt and deletedAt are null on each row, because AdCrunch stored nothing. For a read across ad accounts, or of what AdCrunch stores, call list_creatives. The answer holds at most limit rows (default 100, maximum 500). When it carries nextCursor, more rows exist: call this tool again with the same arguments and cursor set to that value. When it carries no nextCursor, you have every row.

Input

Argument	Type	Required	Description
`advertiserId`	string	yes	The Meta ad account to read, prefixed `acc_`. It must belong to the active organization. Find it with `list_advertisers`.
`ids`	array of (string, at least 1 character), at least 1 item	no	Read only the ad creatives with these ids: the value that each row answers as `id`. To read one, send one id.
`status`	one of `ACTIVE`, `PAUSED`, `DELETED`, `ARCHIVED`	no	Read only the entities that are set to this status, not the entities that deliver. Each row of the answer carries this status. Meta takes `PAUSED` and `ARCHIVED`. Another status fails with `live_read_unsupported`. In its place, call `list_creatives` with `advertiserId` and `status` to read what AdCrunch stores. A status that Meta never uses answers an empty list.
`cursor`	string, at least 1 character	no	The `nextCursor` of the previous page. Omit it to get the first page. Send it with no change, and with the same filters as the request that answered it: a cursor from a different query gets a 400 `invalid_cursor`. Do not build or change a cursor.
`limit`	integer, 1 to 500	no	The greatest number of rows on the page, from 1 to 500. The default is 100. A greater value gets a 400, with `error` of `invalid_request`. Default: `100`.

Output

A successful call returns this object in structuredContent.

Field	Type	Always present	Description
`creatives`	array of object	yes	The ad creatives of the ad account, as Meta holds them now, in the order of Meta. An empty array can carry `nextCursor`: then more rows can exist.
`creatives[].advertiserId`	string	yes	The advertiser that owns it, prefixed `acc_`.
`creatives[].createdAt`	number or null	yes	When AdCrunch first stored this row. Null when the row was read live: AdCrunch holds no copy of it. `createdAt`, `updatedAt` and `deletedAt` are AdCrunch’s own times, so all three are null together on a live row.
`creatives[].createdTime`	number or null	yes	When the provider created the entity. This is the provider’s own time, so a live row carries it. Null where the provider reports none.
`creatives[].currency`	string or null	yes	The account currency, ISO 4217. Every row of one advertiser carries the same one. Null when AdCrunch does not know it yet.
`creatives[].deletedAt`	number or null	yes	When AdCrunch marked the row deleted. A listing never carries a deleted row, so this is null.
`creatives[].id`	string	yes	The id the provider gives, with no prefix. It is unique for one provider and one type, and it may legitimately recur across two types or two providers.
`creatives[].name`	string	yes	The name at the provider.
`creatives[].path`	string	yes	The ancestors and this entity, ids joined by `/`, oldest first. This is what makes a subtree one string comparison.
`creatives[].provider`	string	yes	The ad platform: `meta`, `tiktok` or `gads`. Those three are the providers whose entities AdCrunch reads, and https://docs.adcrunch.dev/connect/providers says how deep each one goes.
`creatives[].status`	one of `ACTIVE`, `PAUSED`, `DELETED`, `ARCHIVED`	yes	The status, normalized across the providers. TikTok `ENABLE` and `DISABLE` read here as `ACTIVE` and `PAUSED`.
`creatives[].updatedAt`	number or null	yes	When AdCrunch last rewrote this row. Null if it never changed.
`creatives[].updatedTime`	number or null	yes	When the provider last edited the entity. Null where the provider reports none.
`creatives[].type`	string	yes	The type the provider uses, kept as the provider writes it: `creative`. Only Meta has a creative of its own. The resource names the concept, and the row keeps the provider’s own word, because a Meta `adset` and a Google Ads `ad_group` are not the same object.
`nextCursor`	string	no	Send this value as `cursor` to get the next page. It is absent on the last page.

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
provider_not_connected
provider_error
live_read_unsupported
invalid_cursor
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.
Open world. The tool reaches a system outside AdCrunch, such as an ad platform.

Example

The arguments:

{
  "advertiserId": "acc_1203456789012345",
  "ids": [
    "120210000000003"
  ]
}

The result, in structuredContent:

{
  "creatives": [
    {
      "advertiserId": "acc_1203456789012345",
      "createdAt": null,
      "createdTime": null,
      "currency": "EUR",
      "deletedAt": null,
      "id": "120210000000003",
      "name": "Bestsellers carousel — FR",
      "path": "120210000000003",
      "provider": "meta",
      "status": "ACTIVE",
      "type": "creative",
      "updatedAt": null,
      "updatedTime": null
    }
  ]
}