영화 데이터베이스 (TMDB) API에 대한 MCP 서버. 영화 및 TV 검색, 스트리밍 가용성, 캐스트 및 승무원 세부 사항 및 Codex 및 Claude 데스크톱과 같은 보조에 대한 권장 사항을 제공합니다.

재사용 가능한 MCP 서버와 더 높은 수준의 기능 워크플로우 사이의 아키텍처를 위해 USERGUIDE.md를 참조하십시오.

도구

영화 발견

• get weekend watchlist - 정취, 국가, 언어, 실행 시간, 등급 및 서비스로 주말 단축 목록 순위
• plan watch party - 1차 픽업, 백업, 와일드카드, 파티-액세서리, 공급자 가용성 및 피제 제목 필터링이있는 그룹 영화 야간 계획
• build franchise watch order - 릴리스 주문과 Franchise/universe 가이드, 제안된 순서, 총 실행 시간 및 공급자 인식 노트
• build collection gap plan - 시계/종료 항목이있는 Franchise 완료 계획, 나머지 실행 시간, 공급자 가용성 및 완료 경로
• recommend from taste profile - 공급자 인식 득점, 일치 이유 및 cautions를 가진 liked/disliked 제목의 추천
• build release calendar watchlist - 곧 영화, 공급자-ready Picks, 넓은 객실 기본 및 시계-later 득점

TMDB MCP Server

An MCP server for The Movie Database (TMDB) API. It provides movie and TV search, streaming availability, cast and crew details, and recommendations for assistants such as Codex and Claude Desktop.

For the architecture split between the reusable MCP server and higher-level feature workflows, see USERGUIDE.md.

Tools

Movie Discovery

• get_weekend_watchlist — Ranked weekend shortlist by mood, country, language, runtime, rating, and services
• plan_watch_party — Group movie-night plan with a primary pick, backup, wildcard, party-fit reasons, provider availability, and avoided-title filtering
• build_franchise_watch_order — Franchise/universe guide with release order, suggested order, total runtime, and provider-aware notes
• build_collection_gap_plan — Franchise completion plan with watched/missing entries, remaining runtime, provider availability, and completion path
• recommend_from_taste_profile — Recommendations from liked/disliked titles with provider-aware scoring, match reasons, and cautions
• build_release_calendar_watchlist — Release-window watchlist with upcoming movies, provider-ready picks, broad-room baselines, and watch-later scoring
• search_movies — Search by title/keywords → titles, IDs, ratings, overviews
• get_trending — Top 10 trending movies (timeWindow: “day” | “week”)
• get_weekly_trending_by_language — Weekly trending movies grouped by original language into English, Hindi, and Telugu
• search_by_genre — Movies by genre name, optional year filter
• advanced_search — Filter by genre, year, min rating, sort, language
• search_by_keyword — Find movies by theme/keyword (e.g. “zombie”, “heist”)

Movie Details

• get_movie_details — Full details: cast, crew, runtime, genres, reviews (by movieId)
• compare_movies — Side-by-side comparison for 2-5 movie IDs with ratings, runtime, cast, director, providers, and best-fit notes
• get_recommendations — Top 5 recommendations based on a movie ID
• get_similar_movies — Similar movies via TMDB’s similarity algorithm
• get_watch_providers — Streaming/rental/purchase availability by country (default: IN)
• find_where_to_watch — Search 1-5 movie titles and return streaming/rental/purchase availability with preferred-service matches

TV Shows

• search_tv_shows — Search TV series by title
• get_trending_tv — Top 10 trending TV shows (timeWindow: “day” | “week”)

People

• search_person — Find actors, directors, crew by name → ID + known works
• get_person_details — Full bio + filmography (movies + TV) by personId
• build_person_watch_path — Actor/director watch path with best-rated, available-now, recent, and starter picks

Resources

• tmdb:///movie/ — Full movie details in JSON (title, cast, director, reviews, poster URL)

Quick Start

1. Get a TMDB API key at themoviedb.org → Account Settings → API