# IMDB API (Unofficial) MCP > IMDB API (Unofficial) connects your AI agent to a massive database of global film and TV metadata. Search titles, audit audience ratings, pull full cast lists, or get deep synopsis details instantly. It's essential for anyone doing media research, journalism, or content auditing who needs reliable cinematic data. ## Overview - **Category:** data-management - **Price:** Free - **Tags:** movie-metadata, tv-shows, film-research, audience-ratings, cast-information, media-auditing ## Description Need to analyze movie trends but hate clicking through dozen different websites? This MCP gives your agent the power of a professional film database directly in your workflow. You can ask it to find titles by keyword, pull audience ratings for instant reception checks, and retrieve complete cast and crew lists for deep character research. It makes complex media auditing feel like a simple conversation with an expert consultant. When you connect this IMDB intelligence through Vinkius, your agent acts as your dedicated filmography resource, giving you up-to-the-minute details on everything from genre patterns to unique title identifiers. This is the essential piece for anyone whose job involves verifying or compiling large amounts of cinematic data. ## Tools ### get_imdb_cast_details Retrieves the full list of actors and crew members for a specific film title using its ID. ### get_imdb_movie_details Gets comprehensive metadata, including synopses, for any IMDB title when provided with its unique ID. ### search_imdb_movies Searches the entire database of movies and TV shows based on keywords you provide. ### check_api_status Checks if the IMDB service is currently running or if there's an issue with the connection. ## Prompt Examples **Prompt:** ``` Search for 'Inception' using IMDB. ``` **Response:** ``` I've retrieved the details for Inception! It was released in 2010 and has a rating of 8.8/10. Would you like the full cast list or the technical metadata for this title? ``` **Prompt:** ``` Show the cast for movie with ID 'tt0111161' (The Shawshank Redemption). ``` **Response:** ``` I've identified the cast for The Shawshank Redemption! Notable actors include Tim Robbins as Andy Dufresne and Morgan Freeman as Ellis Boyd 'Red' Redding. I can provide the full list of crew metadata if you'd like. ``` **Prompt:** ``` Search for TV shows about 'space' on IMDB. ``` **Response:** ``` I've identified several space-themed series! Notable entries include 'The Expanse' and 'Star Trek'. I can provide the ratings and synopsis metadata for each of these titles to assist in your research. ``` ## Capabilities ### Search for Titles Your agent searches across thousands of movies and TV shows using keywords, returning detailed metadata including release years and genres. ### Audit Title Details You retrieve full technical metadata and synopses for any specific title using its unique IMDB ID. ### Identify Cast Members The MCP pulls complete lists of cast and crew members associated with a particular film or show. ### Check Service Health Your agent verifies the current operational status of the IMDB service, ensuring your research pipeline never hits an outage. ## Use Cases ### Fact-Checking an Article Draft A journalist is writing about a film festival lineup. Instead of checking Wikipedia for every single movie, they ask their agent to run `search_imdb_movies` with the genre and year range. The agent returns titles, which the journalist then uses `get_imdb_movie_details` on to verify synopses and ratings before publishing. ### Building a Character Profile A scriptwriter needs to know every notable actor in a franchise. They feed their agent the title ID, and the MCP uses `get_imdb_cast_details` repeatedly, giving them one clean, comprehensive list of talent for reference. ### Competitive Media Auditing An entertainment analyst wants to see if a rival studio is focusing on sci-fi or comedy. They use `search_imdb_movies` with broad keywords and then audit the genres returned, quickly mapping out industry trends. ### Verifying Local Broadcast Rights A content buyer needs to confirm the year and genre of a classic film for licensing. They use `get_imdb_movie_details` with the title ID, getting the required metadata instantly without calling an external database. ## Benefits - Stop copy-pasting cast lists. Use `get_imdb_cast_details` to pull complete crew and actor data for any title in one query. - Verify movie details instantly. Instead of browsing, ask your agent to use `get_imdb_movie_details` to get the synopsis and full metadata using just the ID. - Research multiple titles at once. The `search_imdb_movies` tool lets you find thousands of movies or shows by keyword without leaving your chat window. - Know if the data is reliable. Run `check_api_status` anytime to confirm the MCP connection is active and ready for deep research. - Go beyond simple searches. You can use the API's power to pull audience ratings, letting you assess a title’s critical reception alongside its details. ## How It Works The bottom line is you stop manually searching databases; your AI client just asks for the data, and this MCP delivers it. 1. Subscribe to this MCP and provide your Unofficial IMDB API Key. 2. Connect it using any compatible client, like Claude or Cursor. 3. Instruct your agent on the task—for example, 'Find me movies about space and give me their cast lists.' The tool executes the query and sends back structured metadata. ## Frequently Asked Questions **How do I start searching for movies using the IMDB API (Unofficial) MCP?** Start by calling `search_imdb_movies`. You just need to provide keywords, like 'space opera' or 'sci-fi detective.' The tool returns a list of titles and their unique IDs that you can use next. **Can I get the cast list for a film after searching? (IMDB API Unofficial MCP)** Yes. Once `search_imdb_movies` gives you an ID, you immediately pass it to `get_imdb_cast_details`. This retrieves the complete list of actors and crew members linked to that specific title. **Is this MCP reliable for current data? (IMDB API Unofficial MCP)** You can use `check_api_status` anytime your research workflow hits a snag. This verifies the connection is live and operational before you waste time making complex calls. **What if I only have the title name, not the ID? (IMDB API Unofficial MCP)** You first use `search_imdb_movies` with the title's name. The search result will provide the necessary unique IMDB identifier you need for the other tools. **Does this help me audit genre trends? (IMDB API Unofficial MCP)** Yes, after using `search_imdb_movies` to gather a batch of results, the returned metadata includes genres and years. This lets you analyze patterns across your entire dataset. **How do I find my IMDB API Key?** Register for an account at the [**imdbapi.dev portal**](https://imdbapi.dev/), and you will find your API Key in your dashboard after subscription. Copy and paste it below. **Does it support TV series?** Yes. The API provides metadata and ratings for both movies and television series indexed in the IMDB database. **Can the agent show the full cast list?** Yes. Use the `get_imdb_cast_details` tool providing a title ID to retrieve the list of all actors and their roles.