# OMDb API MCP for AI Agents AI Agent Connect > OMDb API lets your AI agent pull real-time data on movies and TV shows. It grabs IMDb ratings, Rotten Tomatoes scores, cast lists, and plot summaries instantly. Whether you're looking for a specific episode's air date or comparing box office numbers for a film franchise, this Connector connects your agent to the Open Movie Database to get the facts without you having to manually browse dozens of different sites. ## Overview - **Category:** data-analytics - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_sJ5dEoRTHHPejDPTfUwMzYxZrZ7OAjuWZ8fYKiej/ai-agent-connect - **Tags:** movie-metadata, film-ratings, entertainment-data, public-api, media-search ## Description Imagine you are trying to put together a deep-dive analysis of a long-running film franchise or a hit TV series. Right now, that probably means opening twenty different tabs, copy-pasting cast lists from one site, checking a critic's score on another, and trying to remember if a specific movie was a hit or a flop. It is a messy process of manual data entry that eats up your afternoon and makes it hard to stay in the flow of your work. This Connector changes that by giving your AI agent a direct line to the Open Movie Database. Instead of you doing the legwork, you just tell your agent what you need. It can pull full plot synopses, check ratings across three different platforms at once, and grab production studio details in seconds. It turns a chore into a single conversation. You will find this works great because it is a lightweight way to get accurate data without the overhead of a massive, complex database. It is one of the many high-quality integrations you can find on the Vinkius marketplace to make your agent actually useful for research. You get the facts you need, formatted exactly how you want them, without ever leaving your workspace. You can quickly verify a release date, find a director's filmography, or see how a show performed on Rotten Tomatoes. It handles the boring stuff so you can focus on the actual writing, analysis, or planning. Having this data accessible through your agent makes your workflow much faster for fans and professionals alike. ## Tools ### get_by_imdb_id Get complete details for a movie or TV series using its unique IMDb ID. This is the most accurate way to fetch data because IDs don't have naming conflicts. ### get_by_title Look up a movie or series by its exact name. It is perfect for when you don't have an ID handy but want all the metadata. ### get_episode Retrieve specific details for a TV episode using its IMDb ID. Use this to get air dates and synopses for a single show installment. ### get_full_by_imdb_id Get the most detailed information for a movie or series using its IMDb ID. This specifically pulls the full-length plot summary for deep dives. ### get_full_by_title Get the most detailed information for a movie or series by title. This is the best way to get a long plot synopsis without knowing the ID first. ### get_multiple_by_id Fetch details for multiple titles at once using a list of IMDb IDs. This is the fastest way to compare a whole franchise or a list of films. ### get_ratings Pull all available ratings from IMDb, Rotten Tomatoes, and Metacritic for a title. Use this to see how different critics and audiences feel about a show. ### get_short_plot Get a brief summary of a movie or series by title. This works well when you just need a quick refresher on what the story is about. ### search Find movies, TV series, or episodes by a title keyword. It returns a list of matches so you can pick the right one to look up. ### search_episodes Search for specific TV episodes only by title or keyword. This helps you find a single episode when a general search is too cluttered. ### search_movies Search for movies only by keyword to filter out TV shows. This is great for narrowing down a specific film search quickly. ### search_series Search for TV series only by keyword to filter out movies. Use this to find a show when you know it's a series but not the exact name. ## Prompt Examples **Prompt:** ``` What's the deal with the movie 'Inception'? Give me the ratings and a quick plot summary. ``` **Response:** ``` ### Inception (2010) **Ratings:** * **IMDb:** 8.8/10 * **Rotten Tomatoes:** 87% * **Metacritic:** 74/100 **Plot Summary:** A thief who steals corporate secrets through the use of dream-sharing technology is given the inverse task of planting an idea into the mind of a C.E.O. ``` **Prompt:** ``` I'm making a list of 90s action movies. Can you find 5 of them and tell me their box office and ratings? ``` **Response:** ``` | Movie | Year | IMDb Rating | Box Office | | :--- | :--- | :--- | :--- | | Terminator 2 | 1991 | 8.6 | $583M | | Jurassic Park | 1993 | 8.2 | $670M | | Speed | 1994 | 7.4 | $341M | | Independence Day | 1996 | 7.0 | $732M | | Face/Off | 1997 | 7.0 | $229M | ``` **Prompt:** ``` Find the episode details for 'The Bear' episode 101. Who wrote it and when did it air? ``` **Response:** ``` ### The Bear - Season 1, Episode 1 * **Title:** 'Review' * **Air Date:** June 23, 2022 * **Writer:** Christopher Storer * **Director:** Christopher Storer * **Synopsis:** Carmen 'Carmy' Berzatto, a high-end chef, returns home to Chicago to run his family's sandwich shop. ``` ## Capabilities ### Pull full movie synopses Get deep story summaries for any film or TV series with a single request. ### Compare critic ratings See scores from IMDb, Rotten Tomatoes, and Metacritic side by side. ### Fetch TV episode details Grab air dates, writers, and episode-specific synopses instantly. ### Batch check multiple IDs Process a list of movies at once to compare a whole franchise. ### Get box office figures Retrieve theatrical gross totals for movies to see their commercial success. ### Filter search by year or type Narrow down results to specific release years or content types like series and episodes. ## Use Cases ### Comparing a film trilogy A YouTuber wants to write a script about a film trilogy and needs to compare the box office and ratings of all three movies using get_multiple_by_id. ### Identifying production trends A data analyst needs to pull the production studio and release year for 50 different movies to identify trends in the 90s. ### Finding specific episode info A fan wants to find the specific air date and writer for a random episode of a long-running TV show using get_episode. ### Quick content fact-checking A reviewer wants to quickly check if a movie is rated PG-13 or R before writing a parent's guide for a blog. ## Benefits - Stop tab-switching between IMDb and Rotten Tomatoes by using get_ratings to see all scores in one place. - Save time on research with get_multiple_by_id to pull data for an entire movie franchise in one go. - Get accurate data every time with get_by_imdb_id to avoid confusing movies with similar titles. - Write better scripts faster by pulling full-length synopses with get_full_by_title for deep story context. - Easily filter your search results using search_movies or search_series to keep your data clean and relevant. ## How It Works The bottom line is it turns the Open Movie Database into a searchable knowledge base for your AI. 1. Subscribe to the OMDb API MCP on Vinkius. 2. Add your API key to your environment variables. 3. Ask your agent to find a movie or show. ## Frequently Asked Questions **Can I use the OMDb API MCP to find specific TV show episodes?** Yes, it lets you search for specific episodes by title and get details like the air date, director, and synopsis. **Does the OMDb API MCP provide ratings from multiple sites?** It pulls scores from IMDb, Rotten Tomatoes, and Metacritic so you can see the full critical consensus in one place. **How accurate is the movie data in the OMDb API MCP?** It is very reliable, especially when you use the IMDb ID to fetch details, which eliminates any naming confusion. **Can I get plot summaries for movies with this Connector?** Yes, you can choose between a short summary for a quick look or a full-length synopsis for a deep dive into the story. **Is there a limit to how many movies I can look up?** The underlying API allows for 1,000 requests a day, which is plenty for most research and data tasks. **Can I search for movies specifically without seeing TV shows?** Yes, the search_movies tool filters out everything except films so your results stay relevant to your search. **What's the difference between searching by title vs. using an IMDb ID?** Using an IMDb ID (e.g., `tt0468569`) is the most accurate method because IDs are unique — there's never ambiguity between different films with the same name. Searching by title can return errors if multiple films share the same title (e.g., "King Kong" has multiple versions). If you know the IMDb ID from a link or another source, always prefer `get_by_imdb_id`. Use `get_by_title` when you only know the film name. **Can I get ratings from multiple sources (IMDb, Rotten Tomatoes, Metacritic) at once?** Yes! Use the `get_ratings` tool with either a movie title or IMDb ID. It returns all available ratings from IMDb (out of 10), Rotten Tomatoes (percentage), and Metacritic (out of 100) in a single call. Not all titles have all three ratings — newer or less popular films may only have IMDb data. The tool also returns the IMDb vote count and Metascore as separate fields. **Can I look up details for multiple movies at the same time?** Yes! Use the `get_multiple_by_id` tool with comma-separated IMDb IDs (e.g., `tt0468569,tt1375666,tt0816692` for the Dark Knight trilogy). It fetches details for each ID and returns them combined in one response. If any ID fails, it shows an error for that specific ID while still returning results for the others. This is ideal for franchise comparisons or batch analysis. **What's the difference between short and full plot summaries?** The short plot provides a concise 1-2 paragraph summary — ideal for quick identification or brief descriptions. The full plot offers a much more detailed synopsis with deeper plot points, character arcs, and story resolution. Use short for quick lookups (`get_by_title`, `get_short_plot`) and full when users want comprehensive understanding (`get_full_by_title`, `get_full_by_imdb_id`).