MCP/Tools/Images/upload_image
upload_image

Upload an image into your Claivra account

Free

Push a base64 image you already have on disk (cropped, resized, brand-overlayed) into your Claivra media library — usable in create_share, revise_share, edit_image.

How it works

Fills the gap between AI-generated images and locally post-processed files. If you cropped a creative in Photoshop, resized it to an exact ad spec, or composited a brand overlay locally — push it back to Claivra with one call and it shows up alongside AI-generated images. Returns { imageId, imageUrl } usable in every other tool. No credit cost — you're just persisting bytes.

Inputs

Name
Type
Required
Description
imageBase64
string
required
Base64-encoded image data (no data-URI prefix).
mimeType
string
required
e.g. 'image/jpeg' or 'image/png'.
label
string
optional
Short label used in the conceptKey.
brandId
string
optional
Anchor to a brand kit.
generationId
string
optional
Anchor to an existing generation — useful when replacing a concept's image.

Returns

{ imageId, imageUrl, mimeType, generationId, conceptKey }

Examples

Replace wrong-dimension Google Ads in a live client share

Client already has the share link. You resize the Google Ad images locally to exact 1200×628, upload them, then call revise_share to swap them in — same URL preserved.

{
  "imageBase64": "<base64 of the 1200×628 jpeg>",
  "mimeType": "image/jpeg",
  "label": "Tesla1 Google Ad — exact 1200×628",
  "brandId": "aBmbZETe9gUZhwXHCE02"
}

Related tools

edit_image

Edit an existing image with an instruction

Apply a natural-language instruction to an existing image — swap headlines, change colors, remove text, replace backgrounds — without regenerating the whole composition.

revise_share

Send a revision round on a share

Replace one or more images in a share, archive the current round, reset status to 'pending' for re-review.

All toolsGet API key