edit_brand_creative
Make an edited copy of an existing creative image, using AI-powered editing while preserving brand consistency.
Writes creative
Creates or changes something in the account. Put it behind whatever review your agent uses.
What it does
Make an edited copy of an existing creative image, using AI-powered editing while preserving brand consistency. USE FOR: Modify headline/CTA/hero graphic, add/remove elements, adjust styling, create variations, iterate on designs. EDITABLE: Headlines, text, CTA buttons, hero graphics, badges/icons, colors, stats, any combination in single request. EXAMPLES: - Single: "Change headline to 'BOOST YOUR ROI'" - Multiple: "Change headline to 'DRIVE PIPELINE', update CTA to 'LEARN MORE', add +50% badge" PRESERVES (unless asked to change): Logo position/size, brand colors, typography, composition, dimensions. CHAINED EDITS: Use output URL as input for next edit (Edit → URL_1 → Edit → URL_2 → final). OUTPUT: the URL of a NEW image, stored temporarily outside the creatives library. Nothing is edited in place: the source image, and any library creative and id it came from, stay exactly as they were. To keep an edit of a library image, upload the new URL with upload_image_creative, which gives it a NEW library id.
Arguments
| Argument | Type | Notes | |
|---|---|---|---|
image_source |
string | required | URL of the creative image to edit. Must be a valid accessible image URL (PNG, JPG, WebP). Can be a URL returned by a previous generation or edit. |
edit_instruction |
string | required | Natural language description of the desired edit(s). Can include multiple changes in one request. Examples: 'Replace the robot with a dashboard', 'Change headline to BOOST ROI and make CTA say GET STARTED', 'Add a +50% ROI badge in the corner' |
domain |
string | required | Company domain for brand context. Used to fetch brand DNA for consistency. Examples: 'metadata.io', 'bloomreach.com' |
Request
Request template, not a complete runnable example. Replace placeholders, empty objects, arrays, and zero values with valid account-specific inputs. Read required fields and nested constraints in the full schema. Confirm the account, connected channels, and referenced assets before calling a write tool.
curl
curl -s -X POST https://mcp-server.metadata.io/mcp \
-H "Authorization: $METADATA_PAT" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "MCP-Protocol-Version: 2025-11-25" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"edit_brand_creative","arguments":{"image_source":"<image_source>","edit_instruction":"<edit_instruction>","domain":"<domain>"}}}'Response
No recorded response. This tool writes to the account, so it is never executed to build these docs.
The request is an illustrative template. Fill required fields and check the current schema before calling it. No response is fabricated.
Related
Other creative tools: