Tmdb
liveFilm/TVEntertainmentMediaThe Movie Database (TMDB) — search and retrieve movies, TV shows, cast/crew, trailers, and trending content.
Tools
configurationFetch 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.
No parameters required.
Try it
search_movieSearch 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
No parameters required.
Try it
search_tvTMDb (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
No parameters required.
Try it
search_personSearch 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`.
No parameters required.
Try it
search_multiSearch 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
No parameters required.
Try it
movieFetch 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/
No parameters required.
Try it
movie_creditsTMDb 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".
No parameters required.
Try it
movie_videosFetch 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.
No parameters required.
Try it
movie_recommendationsFetch 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.
No parameters required.
Try it
tvFetch 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.
No parameters required.
Try it
tv_seasonFetch 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.
No parameters required.
Try it
tv_episodeFetch 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.
No parameters required.
Try it
personFetch TMDB person details by `person_id`. Returns full name, biography, birthday, deathday, place of birth, known-for department, and profile image path.
No parameters required.
Try it
person_combined_creditsFetch 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.
No parameters required.
Try it
trendingTMDb 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
No parameters required.
Try it
discover_movieDiscover 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.
No parameters required.
Try it
discover_tvDiscover 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.
No parameters required.
Try it
genres_movieTMDb movie genre directory: Action, Comedy, Drama, Horror, Documentary, etc. with genre IDs. Use to filter discover_movie by genre.
No parameters required.
Try it
genres_tvTMDb TV genre directory: Action & Adventure, Drama, Reality, Documentary, Animation, etc. with genre IDs. Use to filter discover_tv by genre.
No parameters required.
Try it
Test with curl
The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.
curl -X POST https://gateway.pipeworx.io/tmdb/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'curl -X POST https://gateway.pipeworx.io/tmdb/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"configuration","arguments":{}}}'Use with the SDK
Install @pipeworx/sdk to call tools from any TypeScript/Node project.
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("configuration", {});// Or ask in plain English:
const answer = await px.ask("the movie database (tmdb) — search and retrieve movies, tv shows, cast/crew, trailers, and trending content");Related packs
Other Pipeworx packs in the same categories (Film/TV, Entertainment, Media):