# sfx MCP tool

Search and import sound effects.

{/* Generated by landing/scripts/generate-mcp-docs.ts. Do not edit. */}

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.