All MCP tools
MCP tools · Finn agents
update_finn_speech_settings
Tunes a draft voice Finn's speech: voicemail behaviour, ending on silence, ring time, noise filtering, how quickly it answers, speaking speed, how easily it can be interrupted, background volume, words to listen for and pronunciations. Only the fields you pass change. For a chat agent only endCallOnSilence applies.
- Scope needed
- finn
- Changes data
- Yes
- Held for approval
- No
- Available to
- Every organization
Only drafts the key's owner created.
Inputs
| Name | Type | Description |
|---|---|---|
| finn_idrequired | string | The Finn's id (a UUID). Use list_finns to find it. |
| voicemailAction | enum: hangup | message | Voice only. On voicemail: hang up, or leave voicemailPrompt. |
| voicemailPrompt | string | Voice only. The message it leaves on voicemail. Empty string clears it. |
| endCallOnSilence | enum: 15 | 20 | 30 | 45 | 60 | 90 | 120 | Seconds of silence after which it ends the conversation. Also applies to chat agents. |
| ringDuration | enum: 15s | 30s | 45s | 60s | 90s | 120s | Voice only. How long an outbound call rings before giving up. |
| denoisingMode | enum: remove-noise | remove-noise-bg | none | Voice only. Filter background noise (and, with remove-noise-bg, background voices). |
| endpointing | number | Voice only. Milliseconds of pause before it decides the caller has finished (50-5000, about 350). |
| ttsSpeed | number | Voice only. Speaking speed, 1 is normal (0.1-3). |
| wordsForInterruption | number | Voice only. Words the caller must say before the Finn stops to listen (1-20). |
| interruptionBackoffMs | number | Voice only. Milliseconds it waits after being interrupted before speaking again. |
| checkUserOnlineMessage | string | Voice only. What it says to check the caller is still there. Empty string clears it. |
| backgroundVolume | number | Voice only. Volume of the background ambience, 10-100. |
| boostedKeywords | string | Voice only. Comma-separated words the transcriber should listen harder for. |
| pronunciations | object[] | Voice only. Replaces the whole pronunciation list: { word, phoneme, type? } items. |