MCP/Tools/Images/create_upload_link
create_upload_link

Upload a photo, logo or finished ad

Free

Get a one-time link to send a real image file into Claivra - by curl, or a drop page the person opens.

How it works

The way to get a real photo, logo or finished ad file into your account. An AI can't paste a photo into a tool call, so this returns an upload link that works once and lasts 30 minutes. Agents that can run commands send the file with one curl -T. In a chat app, the agent gives you the page link: drop the file there, say it's done, and the agent calls get_upload for the image id. The file is kept exactly as-is (no AI re-render) and saved to your media library. PNG, JPEG or WebP, up to 20MB.

Inputs

Name
Type
Required
Description
label
string
optional
Short name for the file, e.g. 'storefront photo'.
brandId
string
optional
File it under a brand kit.

Returns

{ uploadToken, uploadUrl, pageUrl, curl, expiresAt }

Examples

Use the client's real car photo in an ad

You attach a dealership photo in chat. The agent creates an upload link and sends you the page. You drop the photo, the agent calls get_upload, then compose_ad puts the headline and logo on it.

{
  "label": "Dealer forecourt photo"
}