hear
Listens to the specified span of a clip's source audio and reports the spoken words next to the transcript, revealing where transcript and audio disagree.
Instructions
What does clip_id's source audio actually say between start and end?
Use this when the transcript and the audio might disagree — a word with a
suspect duration, a hole with no words in it, a stretch that reads clean
but sounds wrong. It runs the same short-overlapping-window pass
verify(windowed=True) runs, over the clip's own media across the span
(source seconds), and comes back with heard_words/heard_text beside
the attached transcript's own words over that span (transcript_words).
No need to seed, export and verify to hear your source material.
Reports, never attaches — nothing is written and no word index moves.
Where the two disagree, cut_by_time addresses what the transcript has
no word for. heard_words can be empty: silence is a real answer. One
whisper run over the span; end past the clip is refused.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | Yes | Where to stop, in the same source seconds. Past the end of the clip it is refused rather than clamped. | |
| 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. | |
| model | No | The whisper model for this windowed pass. | small |
| start | Yes | Where to start listening, in that clip's own **source** seconds — never timeline seconds and never a word index. | |
| window | No | Length of each window, in seconds. | |
| clip_id | Yes | The clip whose source audio to listen to. | |
| overlap | No | How far each window overlaps the one before it, in seconds. The overlap is what stops a word straddling a boundary from being lost between two windows. | |
| language | No | Force a language code, e.g. `en`. Unset, whisper detects it. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||