# TMDB MCP for AI Agents AI Agent Connect > TMDB (The Movie Database) MCP lets you query a massive library of film and television data. Your AI agent can pull actor biographies, TV season summaries, movie ratings, and release details instantly. It's the go-to way to turn your AI into a film expert that knows everything from indie shorts to blockbuster hits. ## Overview - **Category:** knowledge-management - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_0C6ugaOyy1juWrhQvmxGhYRbtZlwBy2ZJ6bt7IVF/ai-agent-connect - **Tags:** movies, tv-shows, entertainment, film-database, media-metadata ## Description Imagine you're trying to map out the filmography of a niche indie actor or find every horror movie released in 2023 that has a specific rating. Usually, this means opening a dozen tabs, scrolling through messy websites, and copy-pasting text into your notes. With the TMDB MCP, you just ask your AI agent to do the legwork. It pulls the data directly from the world's most reliable cinema database. You'll get specific details on TV episodes, cast biographies, and regional certifications without ever leaving your chat window. It's a huge win for anyone who needs accurate media metadata on demand. Because Vinkius makes it so easy to connect these types of tools, you can jump from researching a script's historical accuracy to checking a production crew's credits in seconds. It's about moving from manual searching to direct data retrieval. ## Tools ### get_account_details Check your TMDB account information quickly. This helps you confirm your current account status. ### get_configuration See your current API configuration details. Use this to verify your connection settings. ### get_movie_certifications Find out the official ratings for a specific movie. This is great for checking regional age limits. ### get_movie_details Get the full data for a single film title. It provides everything from summaries to runtime. ### get_person_details Pull biographies and filmographies for actors and crew. Use this to see an actor's entire career history. ### create_request_token Generate a new request token for your session. This keeps your interaction with the database active. ### search_movies Find movies using simple text search queries. It's the fastest way to locate a specific title. ### get_tv_certifications Look up official ratings for TV shows. This ensures you have the correct regional content data. ### get_tv_details Get complete information on a specific TV series. This includes overview data for the whole show. ### discover_movies Filter movies based on specific genres, ratings, and dates. It helps you find hidden gems in a crowded category. ### create_guest_session Start a new guest session for temporary data access. This is useful for quick, one-off queries. ### get_tv_episode_details Pull specific data for a single TV episode. Use this for granular summaries of a specific show's history. ### get_tv_season_details See the breakdown of a specific TV season. This helps you see how many episodes are in a season. ## Prompt Examples **Prompt:** ``` Who was in the cast for Inception? ``` **Response:** ``` Here is the main cast for **Inception (1999)**: | Actor | Role | | :--- | :--- | | Leonardo DiCaprio | Cobb | | Joseph Gordon-Levitt | Ari | | Elliot Page | Saito | | Ken Watanabe | Saito | | Marion Cotillard | Aurelie | | Cillian Murphy | Robert Fischer ``` **Prompt:** ``` Show me some high-rated sci-fi movies from 2022. ``` **Response:** ``` I found some top-rated sci-fi titles from 2022 for you: * **Everything Everywhere All at Once** (Rating: 8.1) * **The Banshees of Inisherin** (Rating: 7.7) * **Tár** (Rating: 7.6) Would you like more details on any of these? ``` **Prompt:** ``` Give me the details for the first season of Game of Thrones. ``` **Response:** ``` ### **Game of Thrones** - Season 1 **Overview:** The story begins in the land of Westeros, where various noble houses struggle for power. * **Episode Count:** 10 * **Key Events:** The royal wedding, the start of the war of the five kings, and the introduction of the White Walkers. Would you like a summary of a specific episode? ``` ## Capabilities ### Pull movie and TV show metadata Get complete details for specific films, series, seasons, and episodes. ### Find actor and crew biographies Retrieve full filmographies and personal details for industry professionals. ### Filter movies by genre and rating Discover titles based on specific content categories and audience scores. ### Check regional content ratings Access official certifications for movies and TV shows across different regions. ### Manage guest sessions Handle session tokens and account details for personalized data requests. ## Use Cases ### Verifying actor filmographies A scriptwriter needs to know if an actor was active in a specific year. They use get_person_details to see their full history. ### Finding high-rated horror movies A YouTuber wants to find top-rated horror movies from 2023. They use discover_movies with horror and 2023 filters. ### Summarizing TV seasons A TV critic needs a summary of a specific season. They use get_tv_season_details to see the episode count and overview. ### Checking global ratings A developer needs to know the rating of a movie in different countries. They use get_movie_certifications to pull that data. ## Benefits - Stop manual browsing by using search_movies to find titles instantly without switching tabs. - Get accurate actor biographies with get_person_details instead of relying on the AI's internal memory. - Find specific episodes with get_tv_episode_details for precise research on long running series. - Check regional ratings quickly using get_movie_certifications or get_tv_certifications for global data. - Filter large lists of content using discover_movies to find exactly what you need by genre or score. ## How It Works The bottom line is you get instant access to a massive cinema database through a simple chat interface. 1. Subscribe to the TMDB MCP on Vinkius. 2. Provide your TMDB API Read Access Token (v4) in the configuration. 3. Ask your AI client questions about movies, TV shows, or cast members. ## Frequently Asked Questions **What is the TMDB MCP?** The TMDB MCP is a connector that lets your AI client pull real-time movie, TV show, and actor data from The Movie Database. **Can I use the TMDB MCP to find actor biographies?** Yes, you can ask your agent to pull full biographies and career filmographies for almost any actor or production member. **Does the TMDB MCP work for TV shows too?** It works for both movies and TV shows, including specific details for seasons and individual episodes. **How do I get the ratings for a movie using the TMDB MCP?** You can simply ask your AI agent to check the official ratings or certifications for any specific movie title. **Can the TMDB MCP help with content research?** Absolutely. It's perfect for researching production credits, release dates, and cast lists without manual browsing. **Can I find specific TV episodes with the TMDB MCP?** Yes, you can retrieve summaries and specific details for individual episodes of your favorite TV series. **Can I filter movies by specific genres and ratings?** Yes! Use the `discover_movies` tool. You can provide genre IDs in `with_genres` and use other filters like `sort_by` to find highly-rated content. **How do I get information about a specific actor?** Use the `get_person_details` tool with the person's unique ID. It will return their biography, place of birth, and other metadata. **Can I see the episodes of a specific TV season?** Absolutely. Use `get_tv_season_details` by providing the `series_id` and the `season_number`. It will list all episodes in that season.