import_asset MCP tool

MCP name import_asset dispatches to renderer importAsset.

Does not use hosted quota. Local editor operation.

Bring media into the project. action web downloads a direct URL. action local imports absolute file paths. action vectorize converts a raster image or URL to SVG. Editor must be open. Does not use hosted quota. Local editor operation.

Advertised MCP input

This tool is registered with passthrough. The fields below are what listTools advertises. The renderer still validates the child fields for the chosen action or kind. Extra advertised-only values are documented under Reachable behavior.

Field	Type	Required	Constraints	Default	Description
action	enum("web", "local", "vectorize")	yes	—	—	action for import_asset
resultStart	integer	no	min 0; max 9007199254740991	0	First character offset to return. Use 0 for the first call.
resultEnd	integer	no	min 1; max 9007199254740991	8000	Exclusive end offset. resultEnd - resultStart must be at most 8000. Increment resultStart by 8000 to page through large results.

Reachable behavior

Advertised action values match the renderer children: web, local, vectorize.

Renderer child fields

These are the authoritative fields for each action. Send them on the same MCP call. Grouped MCP tools use passthrough, so these fields are not all listed in the advertised schema.

action=web

Renderer tool: importWebAsset.

Download a direct web URL into the current project Assets panel (local import — no Firebase sign-in required). Supports images, videos, audio, and 3D models. Returns an assetId for timelineEdit action addClip. Prefer import_local_assets when the file is already on disk.

Field	Type	Required	Constraints	Default	Description
url	string	yes	—	—	Direct URL to an image, video, audio, 3D model, or other supported asset file.
fileName	string	no	minLength 1; maxLength 180	—	Optional filename to use in the project assets panel.

action=local

Renderer tool: importLocalAssets.

Import one or more local files into the current project Assets panel by absolute path. No Firebase sign-in required. Prefer this over import_web_asset when files are already on disk. Returns assetIds for timelineEdit action addClip.

Field	Type	Required	Constraints	Default	Description
paths	string[]	yes	minItems 1; maxItems 50	—	Absolute local file paths to import into the open project.

action=vectorize

Renderer tool: vectorizeImage.

Convert a project image asset or direct image URL into an SVG vector asset. Use this for logos, icons, flat illustrations, screenshots with simple shapes, or any raster image the AI should reuse as scalable SVG. Returns the new SVG assetId.

Field	Type	Required	Constraints	Default	Description
assetId	string	no	minLength 1	—	Project image asset ID to vectorize. Provide either assetId or imageUrl, not both.
imageUrl	string	no	—	—	Direct public image URL to vectorize. Provide either imageUrl or assetId, not both.
outputName	string	no	minLength 1; maxLength 180	—	Optional SVG filename to create in project assets.
preset	enum("logo", "default", "detailed", "smooth", "sharp", "grayscale")	no	—	"logo"	Tracing preset. Use logo for icons/logos, detailed for illustrations, grayscale for monochrome art.
numberOfColors	number	no	min 2; max 32	8	Palette size for color tracing. Lower values create cleaner, smaller SVGs.
maxDimension	number	no	min 128; max 2048	1024	Longest side, in pixels, used for tracing before SVG generation.
blurRadius	number	no	min 0; max 5	0	Optional pre-trace blur radius to smooth noisy images.
minShapeOutline	number	no	min 0; max 64	4	Discard tiny traced regions. Increase this to simplify noisy SVGs.

Result window

Every local MCP tool accepts resultStart and resultEnd so large payloads can be paged.

• resultStart — first character offset. Default 0.
• resultEnd — exclusive end offset. Default 8000.
• resultEnd - resultStart must be at most 8000 characters.
• Increment resultStart by 8000 to read the next window.