Set Clips Volume
set_clips_volumeSet the volume in dB for all audio clips on a track or selected clip indices, replacing dozens of per-clip edits with one request.
Instructions
Set the volume (in dB) on every audio clip of a track, or on a list of clip indices. One round trip instead of one call per clip - essential for sequences with dozens of clips.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"track_index": "<track_index>",
"volume_db": "<volume_db>"
},
"name": "set_clips_volume"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| volume_db | Yes | Volume in dB applied to every selected clip (0 = unity, max +15) | |
| track_index | Yes | Audio track index (0-based) | |
| clip_indices | No | Optional clip indices on that track. Omit to apply to all clips. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | Whether the tool completed successfully. | |
| data | No | Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it. | |
| tool | Yes | The registered MCP tool name. | |
| error | No | Failure detail when ok is false. |