bulk_update_transcript_speakers is a tool in the Speak AI MCP server. Normalise
speaker names that are ALREADY correct across multiple media files: for example
changing “Frederik S.” to “Frederik” everywhere.
What does it do?
Normalise speaker names that are ALREADY correct across multiple media files: for
example changing “Frederik S.” to “Frederik” everywhere. Applies the same mapping to
every specified media file. NOT a way to identify a speaker across a project:
neither the numeric id nor a default label such as “Speaker 1” refers to the same
person in different files, because speakers are numbered per file in order of
appearance. Renaming “Speaker 1” across many files will label a different person in
each one. Identify the speakers in each file first (get_transcript, or an
identify-speakers automation), then use this tool only to tidy up naming that is
already correct. Match by the speaker’s current LABEL, not by numeric id. A file
whose speakers do not match the mapping is left unchanged and reported as failed.
Re-sending a mapping that has already been applied is a safe no-op, so do not retry
a call that reported success.
Parameters
bulk_update_transcript_speakers takes 2 parameters, all of them required.
| Name | Type | Required | Description |
|---|---|---|---|
mediaIds |
array of string | Yes | Array of media IDs to update speakers for (max 500 per call) |
speakers |
array of object | Yes | Speaker mappings applied to every file in mediaIds. Speakers not listed, and files with no matching speaker, are left untouched. |
Behaviour
The Speak AI MCP server publishes these behaviour hints for
bulk_update_transcript_speakers.
- Can change data in your workspace.
- Can delete or overwrite data. Use with care.
- Repeating an identical call is safe.
- Stays inside Speak AI. Does not reach other systems.
Related
- Media library lists the rest of the Media library category.
- Tool reference lists every Speak AI MCP server tool.
- MCP server covers setup, supported clients, and what agents can do once connected.