MCP/Tools/Images/compose_ad
compose_ad

Turn your own photo into a finished ad

Free

Put the brand logo, headline, sub-line and CTA button over a real photo - the photo itself is never changed.

How it works

For real cars, storefronts, faces and products that must stay exactly as shot. compose_ad lays the logo, headline, sub-line and CTA over your photo using the brand kit's colours and fonts. No AI model touches the photo, so it costs no image credits.

Inputs

Name
Type
Required
Description
baseImageId
string
optional
Your image (from create_upload_link, import_image_from_url or a render). Or pass baseImageUrl.
brandId
string
optional
Brand kit for logo, colours and fonts.
headline
string
optional
Main line of text.
subline
string
optional
Smaller second line.
cta
string
optional
Button text, e.g. 'Book a test drive'.
aspectRatio
string
optional
Output ratio, e.g. '4:5' or '9:16'.

Returns

{ imageId, imageUrl, width, height, creditsUsed: 0, logoComposited }

Examples

Black Friday ad from a forecourt photo

The agent uploads the dealer's photo and composes a 4:5 ad with the offer and a CTA.

{
  "baseImageId": "<imageId>",
  "brandId": "<brandId>",
  "headline": "Black Friday: 0% finance",
  "cta": "Book a test drive",
  "aspectRatio": "4:5"
}