cut_by_transcript
Cut or keep video segments by selecting transcript word ranges, pad cuts into surrounding silence, and preview changes before applying.
Instructions
Cut or keep inclusive word ranges, e.g. cut=[[30, 45], [120, 131]].
Pass exactly one of cut or keep. pad widens each range on both sides
in seconds, to land the cut in the silence between words. The timeline is
snapshotted first, so this is undoable.
Every range echoes back the words it resolved to, plus the few words either
side of it — an index one past the intended phrase reads fine on its own
and is only visibly wrong next to its neighbours. pad_reach names any
neighbour the padding eats, since padding is in seconds and the echoed text
is not.
through_pause=True (cut only) extends each range's trailing edge through
the pause after its last word, whenever that gap is wide enough to have
drawn a [N.Ns] marker in the transcript pane — so cutting a phrase also
removes the dead air after it instead of leaving it playing. A no-op when
the trailing gap is too short to have drawn a marker.
plan=True returns that whole payload — including what the timeline would
become — without writing anything. Prefer it over cutting and undoing.
Refused if a range's first or last word claims a suspect duration (see
attach_transcript/transcribe's suspect_durations) — that word's
end/start is what the cut boundary resolves to, and it is usually
hiding a retake rather than ending where it claims. Check the word, then
retry with confirm_suspect=True if the boundary is actually fine. Under
plan=True these are reported as suspect_boundaries instead of refused.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cut | No | Inclusive word ranges to remove, e.g. `[[30, 45], [120, 131]]`. Pass exactly one of `cut` or `keep`. | |
| pad | No | Widen each range on both sides, in seconds, so the cut lands in the silence between words rather than on them. `pad_reach` names any neighbour the padding eats. | |
| keep | No | Inclusive word ranges to keep, everything else going. Pass exactly one of `cut` or `keep`. | |
| path | No | The project directory to act on. Omit it — the usual case — when this server is bound to a project (started as `proofcut -C DIR mcp`, or inside a project; `ping` says which): it then resolves to that one bound project, a relative path resolves against it, and a path outside it is refused by name. Unbound, `path` is the whole address and omitting it refuses rather than guessing. | |
| plan | No | Resolve the whole call and report what it would do, writing nothing. Prefer it over doing the thing and undoing it. | |
| clip_id | Yes | The transcript the word ranges address. | |
| through_pause | No | Extend each cut's trailing edge through the pause after its last word, wherever that gap was wide enough to draw a `[N.Ns]` marker — so cutting a phrase also takes the dead air after it. A no-op when the gap is short. | |
| confirm_suspect | No | Go ahead even though a boundary word claims a suspect duration. Read the echoed words first — a suspect duration usually means whisper hid a retake inside that word, so the edge is not where it reads. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||