library_creative_list
List the Creatives of your Library, each with its count of Variations.
Ask which ad ideas your Library holds. The agent lists the Creatives of your organization, newest first. Each Creative comes with the number of its Variations.
“Which creatives do we have in the library?”
The agent calls this tool, and calls it again for each next page until the list ends. You see each Creative with its name and its number of Variations. A Creative of your Library is not the creative of an ad account: list_creatives lists those.
This tool is part of the job Bring your own creative.
Reference
List the Creatives of the active organization’s Library, newest first, each with its count of Variations. A Variation is one rendition of the Creative, and it holds one Asset. A Creative of your Library is an ad idea of your organization, with its Variations. It is not the creative of an ad account, which list_creatives lists. Use library_creative_get to read one Creative with its Variations. 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 |
|---|---|---|---|
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 Creatives of this page, newest first, each with its count of Variations and no Variation. A deleted Creative is not in the list. |
creatives[].createdAt |
number | yes | Milliseconds since the Unix epoch, UTC. |
creatives[].createdBy |
string | yes | The user who created the Creative. |
creatives[].deletedAt |
number or null | yes | Always null here. A deleted Creative is not answered. |
creatives[].id |
string | yes | The id of the Creative, crv_…. |
creatives[].name |
string or null | yes | The name a person gave the Creative. null when nobody named it. There is no fallback name. |
creatives[].organizationId |
string | yes | The organization that owns the Creative. |
creatives[].updatedAt |
number or null | yes | When the Creative last changed, in milliseconds since the Unix epoch, UTC. null until its first rename. |
creatives[].variationCount |
number | yes | How many live Variations the Creative holds. The read of one Creative holds the first page of them, and the list of the Variations of the Creative gives each page. |
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.
invalid_cursororganization_unentitledforbiddeninvalid_requestinternal_error
Scope
The token must hold library: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:
{
"limit": 20
}
The result, in structuredContent:
{
"creatives": [
{
"createdAt": 1790000300000,
"createdBy": "usr_2e5b84",
"deletedAt": null,
"id": "crv_5e2a19",
"name": "Spring sale",
"organizationId": "org_3a7f10",
"updatedAt": null,
"variationCount": 2
}
]
}