MCP server exposing 19 tools for tmdb.
This URL is a JSON-RPC 2.0 endpoint over HTTP. Issue POST requests with a JSON-RPC body. Browsers and search crawlers land here on GET.
POST https://gateway.pipeworx.io/tmdb/mcp
Content-Type: application/json
{"jsonrpc":"2.0","id":1,"method":"tools/list"}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 `movie_credits`.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, tv_episode.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/images via `append_to_response`.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", weekly entertainment summary.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.Code samples (curl / TypeScript / one-click client install), schemas, and the live playground are on the pack page:
https://pipeworx.io/packs/tmdb/
Pipeworx is an open MCP gateway connecting AI agents to live data. pipeworx.io