Lists the organization's Ad Creator creatives (AI-generated ad image sets: each concept rendered as one banner per chosen ad format), newest first, paginated by cursor (limit up to 200). Each item is a summary: name, topic, status (planning for a draft still in the wizard, generating, review, partial, failed), ad platforms and format ids, objective (branding, consideration or promotion), product name, concept count, how many banners exist (format_variant_count) and how many are ready (ready_format_variant_count: generated or approved), and a preview_image_url (an absolute link, signed for 24 hours). The concepts and every banner URL come with ad_creator.creatives.get. Content Studio social series are not listed here (social_content_studio.series.list). Creating or regenerating creatives is only possible in the app. Requires view access to the Ad Creator.
Escopo
ad_creator:read
Permissão
Ver o módulo
Tool do MCP
ad_creator_creatives_listNa superfície completa; na compacta, mb_execute_operation com id: "ad_creator.creatives.list".
Custo declarado: até 202 leituras e 0 escritas por chamada (contam na cota diária).
Parâmetros
limitintegerqueryopcional
How many items this page brings at most (see the maximum and the default in the schema).
Padrão: 50
cursorstringqueryopcional
The next_cursor of the previous page, exactly as it came (only for the same list and filters); without it, the first page.
Returns one Ad Creator creative with its brief (topic, product name and description, objective, CTA text, ad platforms, format ids, branding snapshot), its plan (topic_plan) and its concepts (posts): headline, description and status of each, with format_variants, one banner per ad format (format_id, width, height, image_url, status: completed, approved, failed…, and error when it failed). Image URLs (each banner, the concept image, the logo) are absolute links: the organization's own files come signed for 24 hours, so they open without a session (read the creative again for fresh links). Not found for an id of another organization or for a Content Studio social series. Requires view access to the Ad Creator.
Escopo
ad_creator:read
Permissão
Ver o módulo
Tool do MCP
ad_creator_creatives_getNa superfície completa; na compacta, mb_execute_operation com id: "ad_creator.creatives.get".
Custo declarado: até 1 leituras e 0 escritas por chamada (contam na cota diária).
Parâmetros
creative_idstringrotaobrigatório
Creative id (from ad_creator.creatives.list; the same id as in the Ad Creator URL).
Resposta
idstring
Creative id.
namestring
Creative name.
statusstring
planning, generating, review, partial or failed.
postsarray<object>
The concepts generated, with their banners.
created_atnumber
Epoch ms.
topicstring | null
What the creative is about.
ad_platformsarray<string> | null
Ad platforms it is for.
ad_format_idsarray<string> | null
Ad formats rendered for each concept.
ad_objectivestring | null
branding, consideration or promotion.
ad_cta_textstring | null
Call to action text on the banners.
ad_subjectstring | null
What the ads show.
product_namestring | null
The product advertised.
product_descriptionstring | null
Its description in the brief.
concept_countnumber | null
Concepts in the plan.
post_countnumber | null
Concepts generated.
generated_image_countnumber | null
Images generated.
approved_countnumber | null
Banners approved.
topic_planarray<object> | null
The plan: one entry per concept.
branding_snapshotobject | null
The branding the banners were made with.
total_credits_consumednumber | null
AI credits it consumed.
created_bystring | null
Who created it (uid).
created_by_namestring | null
That person's name (null when MB Suite does not know it: a former member).
