Subtitle Toolkit MCP

{
  "type": "object",
  "required": [
    "content",
    "to"
  ],
  "properties": {
    "to": {
      "enum": [
        "srt",
        "vtt",
        "ass",
        "csv",
        "text"
      ],
      "type": "string",
      "description": "Target format. `text` = plain transcript, one line per cue, no timecodes."
    },
    "from": {
      "enum": [
        "auto",
        "srt",
        "vtt",
        "ass",
        "sbv",
        "ttml"
      ],
      "type": "string",
      "description": "Source format (default \"auto\" = detect)."
    },
    "dedupe": {
      "type": "boolean",
      "description": "Only for to=\"text\": collapse consecutive identical lines (rolling-caption transcripts repeat lines). Default false."
    },
    "content": {
      "type": "string",
      "description": "The full subtitle file text."
    }
  }
}

{
  "type": "object",
  "required": [
    "content"
  ],
  "properties": {
    "to": {
      "enum": [
        "srt",
        "vtt"
      ],
      "type": "string",
      "description": "Output format. Default: same as the input."
    },
    "content": {
      "type": "string",
      "description": "The full subtitle file text."
    },
    "drop_empty": {
      "type": "boolean",
      "description": "Drop cues that become empty after cleaning. Default true."
    },
    "remove_tags": {
      "type": "boolean",
      "description": "Strip HTML/WebVTT tags and ASS override codes. Default true."
    },
    "drop_duplicates": {
      "type": "boolean",
      "description": "Drop cues whose text was already seen. Default false."
    },
    "remove_sound_cues": {
      "type": "boolean",
      "description": "Strip [Music], [Applause], ♪ ... ♪ and similar. Default true."
    },
    "remove_speaker_labels": {
      "type": "boolean",
      "description": "Strip leading \"SPEAKER:\" prefixes. Default false — enable only if you want them gone."
    }
  }
}

{
  "type": "object",
  "required": [
    "content"
  ],
  "properties": {
    "ratio": {
      "type": "number",
      "description": "Scale all timings by this factor (new = old x ratio). e.g. 1.0427 for a 25→23.976 fps fix."
    },
    "to_fps": {
      "type": "number",
      "description": "The frame rate of the actual video (used with from_fps)."
    },
    "content": {
      "type": "string",
      "description": "The full subtitle file text."
    },
    "from_fps": {
      "type": "number",
      "description": "The frame rate the subtitles were authored for (used with to_fps)."
    },
    "offset_seconds": {
      "type": "number",
      "description": "Shift every cue by this many seconds. Negative = earlier. e.g. -2.5"
    }
  }
}

{
  "type": "object",
  "required": [
    "content"
  ],
  "properties": {
    "content": {
      "type": "string",
      "description": "The full subtitle file text."
    },
    "max_cps": {
      "type": "number",
      "description": "Max characters per second. Default 20."
    },
    "max_line_length": {
      "type": "number",
      "description": "Max characters per line. Default 42."
    },
    "max_duration_seconds": {
      "type": "number",
      "description": "Maximum cue duration in seconds. Default 7."
    },
    "min_duration_seconds": {
      "type": "number",
      "description": "Minimum cue duration in seconds. Default 0.833 (Netflix 5/6s)."
    }
  }
}

{
  "type": "object",
  "required": [
    "content",
    "append_content"
  ],
  "properties": {
    "to": {
      "enum": [
        "srt",
        "vtt"
      ],
      "type": "string",
      "description": "Output format. Default: same as the input."
    },
    "content": {
      "type": "string",
      "description": "The first subtitle file text."
    },
    "gap_seconds": {
      "type": "number",
      "description": "Extra gap between the two tracks, in seconds. Default 0."
    },
    "append_content": {
      "type": "string",
      "description": "The subtitle file text to append."
    }
  }
}

{
  "type": "object",
  "required": [
    "content",
    "at"
  ],
  "properties": {
    "at": {
      "type": "string",
      "description": "Split point. Accepts \"45:00\", \"1:02:03\", \"90\" (seconds) or \"1:02:03.500\"."
    },
    "to": {
      "enum": [
        "srt",
        "vtt"
      ],
      "type": "string",
      "description": "Output format. Default: same as the input."
    },
    "part": {
      "enum": [
        "a",
        "b"
      ],
      "type": "string",
      "description": "Which half to return. Default \"a\" (before the split point)."
    },
    "content": {
      "type": "string",
      "description": "The full subtitle file text."
    }
  }
}

{
  "type": "object",
  "required": [
    "content"
  ],
  "properties": {
    "twice": {
      "type": "boolean",
      "description": "Set true when the text was mis-decoded twice (nested mojibake). Default false."
    },
    "content": {
      "type": "string",
      "description": "The garbled subtitle text."
    },
    "read_as": {
      "enum": [
        "auto",
        "cp1252",
        "cp1251"
      ],
      "type": "string",
      "description": "Which encoding the file was wrongly read as. Default \"auto\" (tries cp1252 then cp1251)."
    }
  }
}

{
  "type": "object",
  "required": [
    "content"
  ],
  "properties": {
    "content": {
      "type": "string",
      "description": "Plain text, one caption per line. Blank lines are skipped."
    },
    "start_seconds": {
      "type": "number",
      "description": "Timecode of the first cue, in seconds. Default 0."
    },
    "duration_seconds": {
      "type": "number",
      "description": "Seconds each cue stays on screen. Default 2.5."
    },
    "max_chars_per_cue": {
      "type": "number",
      "description": "Split longer lines into several cues at word boundaries. Default 0 = never split."
    }
  }
}

subtitle://formats