MCP tools
Save generated creatives
Save AI-generated creatives into the active brand's creative library.
Tool name: save-generated-creatives.
Save AI-generated creatives into the active brand's creative library. Images made by generate-creatives are stored, but they stay out of the user's library until saved, or until an ad uses them. The ads a chat made are saved into one folder for that chat, at the top of the library. Saving one twice changes nothing.
When to use
When the user asks to keep or save generated ads, or to put them in their library. Not needed before add-ads: an ad can use a creative that is not saved. It writes, so it is unavailable in plan mode.
Access
| Property | Value |
|---|---|
| Required scope | write |
| Publishes | No |
| Read-only | No |
| Destructive | No |
| Idempotent | Yes |
| Open world | No |
Input
| Field | Type | Required | Description |
|---|---|---|---|
creativeIds | integer[] | Yes | The creativeIds from generate-creatives that the user wants to keep. At least 1 item, at most 100 items. |
folderName | string | No | A short name for what this round is (brand and idea), for the folder the chat's ads are saved into. Used only when the chat has no folder yet; the date is added to it. At most 120 characters. |
Output
| Field | Type | Required | Description |
|---|---|---|---|
saved | integer[] | Yes | Generated creatives this call put in the creative library. |
alreadySaved | integer[] | Yes | Generated creatives that were already in the library. |
notSaved | integer[] | Yes | Ids that are not AI-generated creatives of this brand, so nothing was saved for them. |
folders | object[] | Yes | The folder each chat's saved creatives went into. Creatives made outside a chat are saved at the top of the library and are in no folder. |
REST equivalent
POST /v1/brands/{brandId}/creatives/save, Save generated creatives. CLI: koast save-generated-creatives.