sfx MCP tool

MCP name sfx dispatches to renderer sfx.

Does not use hosted quota. Local editor operation.

Search and import sound effects. action search queries the sound library. action import downloads a soundId from search results into the project. 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("search", "import")	yes	—	—	action for sfx
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: search, import.

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=search

Renderer tool: searchSfx.

Search for sound effects to use in the video. Returns sound IDs that can be passed to importSfx. Use this for whooshes, risers, impacts, UI sounds, foley, glitch hits, camera clicks, transitions, and other short effects.

Field	Type	Required	Constraints	Default	Description
query	string	yes	minLength 1	—	Sound effect search query, for example 'whoosh', 'glitch hit', 'riser', or 'camera shutter'
limit	number	no	min 1; max 40	10	Maximum number of sound effects to return
maxDuration	number	no	min 1; max 120	20	Only return sound effects up to this many seconds long

action=import

Renderer tool: importSfx.

Import a sound effect into the current project's Assets panel. Use a soundId returned by searchSfx. After import, the asset can be added to the timeline with timelineEdit action addClip using type='audio' and the returned assetId.

Field	Type	Required	Constraints	Default	Description
soundId	string	yes	minLength 1	—	Sound ID from searchSfx results

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.