MCP tools: assets

Upload images and use photos from Unsplash in components. Agents call these tools for you; this page lists what each one does and the parameters it takes.

list_assets

List assets. Read-only. List uploaded images with their URLs and metadata. Filter by funnel before choosing an image for a component.

Parameter	Type	Required	Description
`funnel`	string	no	Funnel id (fn_…) or slug
`projectId`	string	no	Project to read; omitted = the current project. Does not switch projects

upload_asset

Upload asset. Changes the draft or settings; live funnels change only after publishing. Upload an image into a funnel asset library and return its URL. Provide exactly one of url (public HTTPS image URL), fileBase64 (remote MCP), or filePath (local stdio only). Then use update_component to place the returned URL in an image prop.

Parameter	Type	Required	Description
`funnel`	string	yes	Funnel id (fn_…) or slug
`name`	string	no	Display/original filename, e.g. hero.png
`url`	string	no	Public HTTPS URL of the image to download and upload.
`fileBase64`	string	no	Base64 encoded image bytes. Supported: JPG, PNG, WEBP, GIF, HEIC.
`filePath`	string	no	Local path readable by the MCP server process; only works for local stdio agents.

search_unsplash

Search unsplash. Read-only. Search Unsplash for free photos to use in image props. Returns hotlinked URLs, photographer attribution, and downloadLocation for use_unsplash_photo.

Parameter	Type	Required
`query`	string	yes
`page`	integer	no
`perPage`	integer	no
`orientation`	”landscape” \| “portrait” \| “squarish”	no

use_unsplash_photo

Use unsplash photo. Changes the draft or settings; live funnels change only after publishing. Track selection of an Unsplash photo via its downloadLocation and return the hotlinked image URL to place in component props.

Parameter	Type	Required	Description
`downloadLocation`	string	yes
`fallbackUrl`	string	no

​list_assets

​upload_asset

​search_unsplash

​use_unsplash_photo

list_assets

upload_asset

search_unsplash

use_unsplash_photo