# subtitles

> Reference for the subtitles tool of Recaloo: every action and what it does.

Source: https://recaloo.io/docs/reference/subtitles/

Subtitles of a kept recording in many languages: transcription with speaker diarization (ElevenLabs, OpenAI, xAI, Deepgram), translation by an AI model, SRT and WebVTT files.

Call it as the `subtitles` tool of the Recaloo MCP server with `action` and `args`.

## Actions

| Action | What it does |
|---|---|
| `create` | Makes subtitles of a kept recording: transcribes it with speaker diarization, then (auto_translate, on by default here) translates it into every language. |
| `status` | One job: status, speakers, cost so far, and every track with its status, progress and error. |
| `export` | One language's subtitle file as text: format srt (default) or vtt; speaker_labels:true puts the speaker's name where the speaker changes. |
| `list` | The workspace's subtitle jobs, newest first, with their tracks' status. |
| `translate` | Translates the job's chosen transcript into more (or the same, again) languages, optionally with another translator; cost_cap_usd raises the job's cap. |
| `speakers` | Names the speakers: speakers is a list of objects, each with id (s1, s2 … as status lists them) and name (for example Mehdi). |

> [!TIP]
> Ask for the exact arguments of any action with `action: "help", of: "create"`. The server answers from its own definitions, so that answer is always current.