search_subtitles

search_subtitles

Find subtitles for movies and TV shows using title, IMDB/TMDB IDs, file hashes, or episode details with language and format filtering.

Instructions

Search for subtitles using OpenSubtitles API with comprehensive parameter support

Input Schema

Name	Required	Description
`ai_translated`	No	Include AI translated subtitles (exclude, include, only)
`episode_number`	No	Episode number for TV episodes
`foreign_parts_only`	No	Include foreign parts only subtitles (exclude, include, only)
`hearing_impaired`	No	Include hearing impaired subtitles (exclude, include, only)
`imdb_id`	No	IMDB ID for exact movie/series matching
`languages`	No	Comma-separated language codes (e.g., 'en,es,fr')
`machine_translated`	No	Include machine translated subtitles (exclude, include, only)
`moviebytesize`	No	File size in bytes for hash matching
`moviehash`	No	OpenSubtitles file hash for exact matching
`order_by`	No	Sort order (language, download_count, new, rating)
`order_direction`	No	Sort direction (asc, desc)
`parent_imdb_id`	No	Parent IMDB ID for TV series
`parent_tmdb_id`	No	Parent TMDB ID for TV series
`password`	No	OpenSubtitles.com password for authentication
`query`	No	Text search query
`season_number`	No	Season number for TV episodes
`tmdb_id`	No	TMDB ID for exact movie/series matching
`trusted_sources`	No	Only trusted sources (exclude, include, only)
`username`	No	OpenSubtitles.com username for authentication
`year`	No	Release year

Input Schema (JSON Schema)

{
  "additionalProperties": false,
  "properties": {
    "ai_translated": {
      "description": "Include AI translated subtitles (exclude, include, only)",
      "type": "string"
    },
    "episode_number": {
      "description": "Episode number for TV episodes",
      "type": "number"
    },
    "foreign_parts_only": {
      "description": "Include foreign parts only subtitles (exclude, include, only)",
      "type": "string"
    },
    "hearing_impaired": {
      "description": "Include hearing impaired subtitles (exclude, include, only)",
      "type": "string"
    },
    "imdb_id": {
      "description": "IMDB ID for exact movie/series matching",
      "type": "number"
    },
    "languages": {
      "description": "Comma-separated language codes (e.g., 'en,es,fr')",
      "type": "string"
    },
    "machine_translated": {
      "description": "Include machine translated subtitles (exclude, include, only)",
      "type": "string"
    },
    "moviebytesize": {
      "description": "File size in bytes for hash matching",
      "type": "number"
    },
    "moviehash": {
      "description": "OpenSubtitles file hash for exact matching",
      "type": "string"
    },
    "order_by": {
      "description": "Sort order (language, download_count, new, rating)",
      "type": "string"
    },
    "order_direction": {
      "description": "Sort direction (asc, desc)",
      "type": "string"
    },
    "parent_imdb_id": {
      "description": "Parent IMDB ID for TV series",
      "type": "number"
    },
    "parent_tmdb_id": {
      "description": "Parent TMDB ID for TV series",
      "type": "number"
    },
    "password": {
      "description": "OpenSubtitles.com password for authentication",
      "type": "string"
    },
    "query": {
      "description": "Text search query",
      "type": "string"
    },
    "season_number": {
      "description": "Season number for TV episodes",
      "type": "number"
    },
    "tmdb_id": {
      "description": "TMDB ID for exact movie/series matching",
      "type": "number"
    },
    "trusted_sources": {
      "description": "Only trusted sources (exclude, include, only)",
      "type": "string"
    },
    "username": {
      "description": "OpenSubtitles.com username for authentication",
      "type": "string"
    },
    "year": {
      "description": "Release year",
      "type": "number"
    }
  },
  "type": "object"
}

OpenSubtitles MCP Server

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from OpenSubtitles MCP Server

Related Tools

MCP directory API