UpcomingMCU API

UpcomingMCU (UMCU) API is a free, consumable-only REST API to retrieve data about the productions within the Marvel Cinematic Universe (MCU).

Installation

Before starting, ensure you have Docker and Docker Compose installed.

1. Obtain an "API Read Access Token" from TMDB. This token will be used in step 3.

2. Create a folder for the project. The location does not matter (such as the home directory).

mkdir umcu
cd umcu

2. Run the following commands to download the required files. Make sure default.conf.template is in the nginx directory.

wget https://raw.githubusercontent.com/seaneoo/umcu-api/refs/heads/main/docker/compose.yaml
wget https://raw.githubusercontent.com/seaneoo/umcu-api/refs/heads/main/docker/nginx/default.conf.template --directory-prefix=nginx/default.conf.template

3. Set the following environment variables on your machine. It is recommended that MONGO_USERNAME and MONGO_PASSWORD are secure, random strings.

export MONGO_USERNAME=[change me]
export MONGO_PASSWORD=[change me]
export TMDB_API_KEY=[your api read access token]
export TMDB_LIST_ID=8289533

4. Run the Docker container.

docker compose -f compose.yaml up -d

Data

This product uses the TMDB API but is not endorsed or certified by TMDB.

Check them out here: The Movie Database.

License

GNU GPLv3