@pipeworx/tmdb

Connect: https://gateway.pipeworx.io/tmdb/mcp · Install: one-click buttons

Tools: 19

The Movie Database (TMDB) v3 MCP — film + TV + people. Free key (non-commercial use).

Auth

• Platform: PLATFORM_TMDB_KEY. BYO: ?_apiKey=….

Tools

• configuration() — image config + change keys
• search_movie(query, year?, primary_release_year?, page?, language?, region?, include_adult?) — movie search
• search_tv(query, first_air_date_year?, year?, page?, language?, include_adult?) — TV search
• search_person(query, page?, language?, include_adult?) — person search
• search_multi(query, page?, language?, include_adult?) — multi-type search
• movie(movie_id, append_to_response?, language?) — movie detail
• movie_credits(movie_id, language?) — cast/crew
• movie_videos(movie_id, language?) — trailers/clips
• movie_recommendations(movie_id, page?, language?) — recommended movies
• tv(tv_id, append_to_response?, language?) — TV show detail
• tv_season(tv_id, season_number, language?) — season detail
• tv_episode(tv_id, season_number, episode_number, language?) — episode detail
• person(person_id, append_to_response?, language?) — person detail
• person_combined_credits(person_id, language?) — film + TV credits
• trending(media_type, time_window, page?, language?) — trending
• discover_movie(...) — discover movies (passes through query params)
• discover_tv(...) — discover TV
• genres_movie(language?) — movie genres
• genres_tv(language?) — TV genres

Data source

https://api.themoviedb.org/3

Tools

• configuration — Fetch TMDB API configuration including base image URL, supported poster/backdrop sizes, and change keys. Use to construct full poster/backdrop image URLs from relative paths returned by other tools.
• search_movie — Search TMDB for movies by title keyword. Optionally filter by year or primary_release_year. Returns title, release date, overview, popularity, vote average, and TMDB movie_id needed by movie and `mo
• search_tv — TMDb (The Movie Database) — search TV shows by title. Returns show name, first-air date, popularity, overview, poster path, TMDb tv_id. Use to resolve a TV title into the tv_id needed by tv, tv_season
• search_person — Search TMDB for actors, directors, or crew members by name. Returns person name, popularity, known-for department, profile path, and TMDB person_id needed by person and person_combined_credits.
• search_multi — Search TMDB across movies, TV shows, and people simultaneously with a single keyword query. Returns mixed results each tagged with media_type (movie/tv/person), useful when the content type is unknown
• movie — Fetch full TMDB movie details by movie_id. Returns title, tagline, overview, runtime, genres, release date, budget, revenue, vote average, and production companies. Optionally append credits/videos/
• movie_credits — TMDb full cast + crew for a movie by ID. Returns actor names, characters, order, department, job. Use for “who played X in Y”, “who directed Y”, “behind-the-scenes credits”.
• movie_videos — Fetch trailers, teasers, clips, and featurettes for a TMDB movie by movie_id. Returns video name, site (YouTube/Vimeo), key (video ID), type, and official flag.
• movie_recommendations — Fetch TMDB-recommended movies similar to a given movie by movie_id. Returns title, overview, release date, popularity, vote average, and poster path for each recommended film.
• tv — Fetch full TMDB TV show details by tv_id. Returns name, overview, first/last air date, number of seasons and episodes, genres, networks, status, and vote average.
• tv_season — Fetch details for a specific TV season by tv_id and season_number. Returns season name, overview, air date, episode count, and a list of episodes with name, air date, and overview.
• tv_episode — Fetch details for a specific TV episode by tv_id, season_number, and episode_number. Returns episode name, overview, air date, runtime, vote average, guest stars, and crew.
• person — Fetch TMDB person details by person_id. Returns full name, biography, birthday, deathday, place of birth, known-for department, and profile image path.
• person_combined_credits — Fetch all movie and TV credits for a TMDB person by person_id. Returns cast and crew entries with title, character/job, media type, release date, and vote average.
• trending — TMDb trending movies, TV shows, or people for a time window (day or week). Returns ranked list with name, popularity, vote average, overview. Use for “what is popular this week”, “trending celebrities
• discover_movie — Discover TMDB movies using advanced filters passed as query params (genre, year, certification, vote average, sort order, etc.). Use genres_movie to get valid genre IDs first.
• discover_tv — Discover TMDB TV shows using advanced filters passed as query params (genre, first_air_date, vote average, network, sort order, etc.). Use genres_tv to get valid genre IDs first.
• genres_movie — TMDb movie genre directory: Action, Comedy, Drama, Horror, Documentary, etc. with genre IDs. Use to filter discover_movie by genre.
• genres_tv — TMDb TV genre directory: Action & Adventure, Drama, Reality, Documentary, Animation, etc. with genre IDs. Use to filter discover_tv by genre.