MCP/Tools/Images/import_image_from_url
import_image_from_url

Import an image from a link

Free

Bring an image that's already online into Claivra - Dropbox and Google Drive share links included.

How it works

Claivra downloads the image itself, so you only pass the link. Dropbox and Google Drive share links work when shared 'anyone with the link'. The file is kept exactly as-is and saved to your media library. If a site blocks downloads, the error says so and points to create_upload_link. PNG, JPEG or WebP, up to 20MB.

Inputs

Name
Type
Required
Description
imageUrl
string
required
Public link to the image.
label
string
optional
Short label used in the conceptKey.
brandId
string
optional
File it under a brand kit.

Returns

{ imageId, imageUrl, mimeType, generationId, conceptKey, savedToMedia }

Examples

Pull a product shot from the client's Drive

The client shares a Drive link. The agent imports it and uses it as the base for compose_ad.

{
  "imageUrl": "https://drive.google.com/file/d/<id>/view",
  "label": "Hero product shot"
}