download_subtitle

download_subtitle

Download subtitle files from OpenSubtitles by file ID with format selection, FPS conversion, time shifting, and authentication options.

Instructions

Download subtitle content by file ID with format selection. Requires authentication (API key or username/password).

Input Schema

Name	Required	Description
`file_id`	Yes	File ID from search results (found in files array of subtitle results)
`file_name`	No	Desired file name for the downloaded subtitle
`force_download`	No	Set subtitle file headers to force download
`in_fps`	No	Input FPS for subtitle conversion (must use with out_fps)
`out_fps`	No	Output FPS for subtitle conversion (must use with in_fps)
`password`	No	OpenSubtitles.com password (use with username)
`sub_format`	No	Subtitle format (from /infos/formats endpoint, e.g. srt, ass, vtt)
`timeshift`	No	Time shift in seconds to add/remove (e.g. 2.5 or -1)
`user_api_key`	No	Your OpenSubtitles API key for authenticated downloads
`username`	No	OpenSubtitles.com username (alternative to API key)

Input Schema (JSON Schema)

{
  "additionalProperties": false,
  "properties": {
    "file_id": {
      "description": "File ID from search results (found in files array of subtitle results)",
      "type": "number"
    },
    "file_name": {
      "description": "Desired file name for the downloaded subtitle",
      "type": "string"
    },
    "force_download": {
      "description": "Set subtitle file headers to force download",
      "type": "boolean"
    },
    "in_fps": {
      "description": "Input FPS for subtitle conversion (must use with out_fps)",
      "type": "number"
    },
    "out_fps": {
      "description": "Output FPS for subtitle conversion (must use with in_fps)",
      "type": "number"
    },
    "password": {
      "description": "OpenSubtitles.com password (use with username)",
      "type": "string"
    },
    "sub_format": {
      "description": "Subtitle format (from /infos/formats endpoint, e.g. srt, ass, vtt)",
      "type": "string"
    },
    "timeshift": {
      "description": "Time shift in seconds to add/remove (e.g. 2.5 or -1)",
      "type": "number"
    },
    "user_api_key": {
      "description": "Your OpenSubtitles API key for authenticated downloads",
      "type": "string"
    },
    "username": {
      "description": "OpenSubtitles.com username (alternative to API key)",
      "type": "string"
    }
  },
  "required": [
    "file_id"
  ],
  "type": "object"
}

OpenSubtitles MCP Server

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from OpenSubtitles MCP Server

Related Tools

MCP directory API