# The Movie Database (TMDb) MCP for AI Agents AI Agent Connect > The Movie Database (TMDb) MCP connects your AI agent to a massive repository of movie and TV show data. It lets you search for titles, pull deep metadata like budgets and runtimes, find cast and crew lists, and get official trailers or recommendations instantly. It's the same data used by major streaming services, put into a format your AI can actually use to answer questions. ## Overview - **Category:** knowledge-management - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_PwpTsQbfR9xNdl8ZJhMlsLyVzRo7NqNWmg3ZzOR6/ai-agent-connect - **Tags:** movies, tv-shows, metadata, entertainment-data, media-search, cast-information ## Description This Connector connects your AI agent to the same massive repository of film and TV show data used by major streaming platforms. You don't have to jump between different websites to find out who directed a film, what its budget was, or which actors were in the cast. It lets your agent pull that info directly into your conversation. It works for everything from finding official YouTube trailers to getting a list of similar movies based on what you already like. You can ask for deep metadata like production studios and genres, or just see what's trending this week. If you're tired of your agent guessing at details or giving you outdated info, this is the fix. By connecting this through the Vinkius catalog, you're giving your agent a direct line to the most reliable entertainment database on the web. It's built for anyone who wants facts, not just vibes. ## Tools ### get_genres Retrieve the full list of movie and TV genres along with their unique IDs. Use these IDs to filter your movie searches. ### get_movie Pull every available detail for a movie from runtime to budget. It provides a complete metadata snapshot for any specific title. ### get_movie_credits Get a full list of actors and their characters for a specific movie. This tool also provides details on the director, producers, and other key crew members. ### get_movie_recommendations Get a list of similar movies based on a specific title. This uses a dedicated algorithm to find content you will actually enjoy. ### get_movie_videos Fetch YouTube links for official trailers, teasers, and behind the scenes clips. It provides direct access to promotional content. ### popular_movies See a list of the most popular movies currently trending in specific regions. It helps you identify what is hot right now. ### popular_tv See which TV shows are currently trending based on user activity. It includes show names, first air dates, and overview descriptions. ### search_movies Search the database for movies using titles, keywords, or specific release years. It returns titles, dates, and overviews. ### search_multi Search for movies, TV shows, and people at the same time in a single query. This is ideal for broad entertainment searches. ### discover_movies Filter movies by very specific criteria like studio, year, and minimum rating. It helps you find niche content quickly. ### search_tv Look up TV shows by name, keyword, or first air date. It returns episode counts and overview descriptions for each series. ### top_rated_movies Find the highest-rated movies of all time based on user votes. This helps you identify the critically acclaimed classics. ### find_by_external_id Convert IMDb or TVDb IDs into TMDb entries. This is perfect for linking different databases together. ### top_rated_tv Find the most critically acclaimed TV series ever made. It provides a list of the highest-rated shows based on user ratings. ### trending See what content is currently hot today or this week across all media types. This includes movies, TV shows, and people. ## Prompt Examples **Prompt:** ``` Who directed the movie Interstellar and who else was in the cast? ``` **Response:** ``` ### Interstellar (2014) **Director:** Christopher Nolan **Main Cast:** * **Matthew McConaughey** as Joseph Cooper * **Anne Hathaway** as Dr. Brand * **Jessica Chastain** as Dr. Amelia Brand * **Michael Caine** as Professor Brand * **Bill Nighy** as Rommie Would you like to see the full crew list or find similar movies? ``` **Prompt:** ``` What are some popular action movies from 2023 with a rating over 8? ``` **Response:** ``` Here are some highly-rated action films from 2023: | Movie | Rating | Overview | | :--- | :--- | :--- | | **John Wick: Chapter 4** | 8.2 | A baba yaga is unleashed upon a new generation of killers. | | **Citadel** | 8.1 | A group of spies must team up to save the world. | | **Mission: Impossible - Dead Reckoning** | 7.8 | Ethan Hunt leads his team on a new dangerous mission. | ``` **Prompt:** ``` I liked The Matrix. What are some similar movies I should watch? ``` **Response:** ``` Based on your interest in **The Matrix**, here are some similar recommendations: * **Inception** - A thief who steals corporate secrets through dream-sharing technology. * **The Truman Show** - A man discovers his life is actually a reality show. * **Blade Runner 2049** - A young blade runner's discovery leads him to control of old memories. * **Ghost in the Shell** - A cyborg security agent hunts a mysterious hacker. ``` ## Capabilities ### Search movies and TV shows Find specific titles, series, or people using keywords and filters. ### Pull deep metadata Get production budgets, runtimes, studio info, and release dates instantly. ### Retrieve cast and crew lists Get full lists of actors, their characters, and the people behind the camera. ### Fetch official trailers Get direct YouTube links for trailers, teasers, and behind the scenes clips. ### Get personalized recommendations Receive a list of similar movies based on a specific title you enjoy. ### Discover trending content See what is currently popular today or this week across all media types. ## Use Cases ### Finding Cast for a Video Essay A content creator asks the agent to find the full cast for Inception and get the official trailer links to include in their script. ### Planning a Movie Night A user asks for popular horror movies from the 1990s with a rating over 8 to find something high-quality to watch. ### Production Fact Checking A researcher needs to know the exact production budget and studio for the latest Marvel movie to include in a report. ### Tracking Regional Trends A media analyst asks what is currently trending in the UK for TV shows to see what content is gaining traction. ## Benefits - Stop manual searching by using search_multi to find movies, TV shows, and people in one go. - Get exact production budgets and studio details with get_movie for accurate research. - Pull official YouTube trailer links instantly with get_movie_videos without leaving your chat. - Find high-quality content using top_rated_movies and top_rated_tv to see what is actually well-regarded. - Get personalized watch suggestions with get_movie_recommendations to find similar titles you will like. - Access full cast and crew lists for any title with get_movie_credits to see every person involved in a production. ## How It Works The bottom line is you get a live, searchable entertainment database hooked directly into your AI. 1. Subscribe to this Connector and grab your TMDb API Key. 2. Enter your API key into your AI client's configuration settings. 3. Ask your agent to find movies, pull cast lists, or fetch trailer links. ## Frequently Asked Questions **Can the Movie Database (TMDb) MCP find specific cast members?** Yes, it pulls full cast and crew lists for any movie or TV show. You can get details on actors, their characters, and the people behind the scenes like directors and producers. **Does the Movie Database (TMDb) MCP include trailer links?** Yes, it fetches official YouTube links for trailers, teasers, and behind the scenes clips directly from the database. **Can I use the Movie Database (TMDb) MCP to find trending shows?** Yes, it provides live data on what is currently trending today or this week across movies, TV shows, and people. **How does the Movie Database (TMDb) MCP handle IMDb IDs?** It can convert IMDb IDs and other external identifiers into TMDb entries, making it easy to link data between different entertainment databases. **Can the Movie Database (TMDb) MCP filter by studio?** Yes, you can discover movies by specific production studios like Warner Bros or Marvel Studios using the advanced discovery tools. **Is the Movie Database (TMDb) MCP good for finding high-rated TV shows?** Absolutely. It has a dedicated tool to retrieve the highest-rated TV shows of all time based on user ratings and popularity. **How do I find movies similar to one I already watched and loved?** Use the `get_movie_recommendations` tool with the TMDb ID of the movie you loved. TMDb's algorithm analyzes genre, keywords, cast, crew, and user rating patterns to suggest films you're likely to enjoy. For example, if you loved The Dark Knight (ID: 155), the tool will recommend similar superhero and crime thrillers. You can find the TMDb ID by first using `search_movies` with the title. **Can I filter movies by a specific studio like Warner Bros. or Marvel?** Yes! Use the `discover_movies` tool with the `with_companies` parameter. Studio IDs include: 17 (Warner Bros.), 420 (Marvel Studios), 33 (Universal Pictures), 2 (Walt Disney Pictures), 5 (Columbia Pictures), 12 (New Line Cinema). You can combine with other filters like genre, year, or minimum rating. For example: genre="878" (Sci-Fi), with_companies="420" returns all Marvel sci-fi movies sorted by popularity. **Can I watch trailers directly through this integration?** The `get_movie_videos` tool retrieves all official trailers, teasers, and promotional videos for any movie. Each result includes a YouTube video key. You can watch the trailer by visiting https://www.youtube.com/watch?v={key}. The tool returns videos sorted by type (Trailer, Teaser, Behind the Scenes) with resolution and official status information. **How can I find what movies are trending right now?** Use the `trending` tool with media_type="movie" and time_window="day" for today's trending movies, or time_window="week" for this week's trends. You can also use media_type="all" to see mixed results (movies, TV shows, and people) or media_type="tv" for trending series. Results include popularity scores, vote averages, and poster images. **Can I convert an IMDb ID to a TMDb entry?** Yes! Use the `find_by_external_id` tool with the IMDb ID (e.g., "tt0111161" for The Shawshank Redemption) and external_source="imdb_id". The tool will return the matching TMDb movie, TV show, or person with the TMDb ID, which you can then use with other tools like `get_movie`, `get_movie_credits`, or `get_movie_videos`. This is essential for cross-referencing between IMDb and TMDb databases.