Download PDFMarkdown Version
ClaudeChatGPTPerplexityGeminiMicrosoft CopilotRaycastMeta AIGrokZ.aiQwenKimi
DeepSeekMistralCursorVS CodeWindsurfJetBrainsClineLovableVercel AI SDKLangChain

Use OMDb API with your AI.

Connect your account once and let the AI you already use work with it, without building another integration. Search movies & TV shows, get ratings, cast, plot details, and IMDb data via the Open Movie Database API.

Included with plan

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Complete set · 12 capabilities

The complete OMDb API capability set.

These are the exact actions your AI can choose when you ask it to work with OMDb API.

Capability set01 / 03

01-04

4 capabilities in this set.

Part of 12 available through OMDb API.

  1. 01

    Get by imdb ID

    G., "tt0468569" for The Dark Knight). Returns: Title, Year, Rated (content rating), Released (date), Runtime, Genre, Director, Writer, Actors, Plot, Language, Country, Awards, Ratings (IMDb, Rotten Tomatoes, Metacritic), Metascore, imdbRating, imdbVotes, imdbID, Type (movie/series/episode), DVD release date, BoxOffice gross, Production studio, and Website. Use this when you have an IMDb ID and need complete movie/series information. This is the most accurate method. IMDb IDs are unique and unambiguous. Optional plot parameter: "short" (brief synopsis) or "full" (complete plot summary). Get complete details for a movie or TV series using its IMDb ID

  2. 02

    Get episode

    Returns: Title (episode name), Year (air year), Released (air date), Runtime, Genre, Director, Writer, Actors, Plot (episode synopsis), Language, Country, Ratings, imdbRating, imdbVotes, imdbID, and Type (episode). Use this after finding an episode via search_episodes to get its full details. The IMDb ID is required. get it from search results or from a TV series season/episode listing. Get details for a specific TV episode using its IMDb ID

  3. 03

    Get full by title

    This is the same as get_by_title but always uses plot="full" for the most comprehensive synopsis. Returns: Title, Year, Rated, Released, Runtime, Genre, Director, Writer, Actors, full Plot, Language, Country, Awards, Ratings (IMDb, Rotten Tomatoes, Metacritic), Metascore, imdbRating, imdbVotes, imdbID, Type, DVD release date, BoxOffice gross, Production studio, and Website. Use this when users want the complete plot summary and all metadata for a specific title. The full plot can be significantly longer than the short version, providing deeper synopsis detail. Get the most detailed information for a movie or series by title

  4. 04

    Get ratings

    Also returns: Title, Year, Type, imdbRating, imdbVotes, and Metascore as individual fields. Use this when users ask "what is the rating of...", "how is X rated?", or want to compare scores across platforms. You can search by title (first parameter) or by IMDb ID (set use_imdb_id=true for the second parameter). Note: Not all titles have ratings from all three sources. some may be missing. Get all available ratings (IMDb, Rotten Tomatoes, Metacritic) for a movie or series

Capability set02 / 03

05-08

4 capabilities in this set.

Part of 12 available through OMDb API.

  1. 05

    Get short plot

    The short plot provides a concise synopsis. ideal for quick identification or brief descriptions. Returns: Title, Year, Rated, Runtime, Genre, Director, Actors, short Plot, Ratings, and other metadata. Use this when users want a quick summary without the lengthy full plot. For the complete synopsis, use get_full_by_title or get_full_by_imdb_id instead. Get a brief plot summary for a movie or series by title

  2. 06

    Search

    Returns a paginated list of matching titles. Each result includes: Title, Year, IMDb ID, Type (movie/series/episode), and Poster URL. Results are paginated (10 per page); use the page parameter to get more results (pages 1-100). Use this when users ask to "find movies about..." or "search for..." a topic. Optional filters: type (movie/series/episode) and year (YYYY format). Note: Search results are brief. use get_by_imdb_id or get_by_title with the returned IMDb ID for full details. Search for movies, TV series, or episodes by title keyword

  3. 07

    Search episodes

    Returns a paginated list of matching episode titles. Each result includes: Title, Year, IMDb ID, Type (always "episode"), and Poster URL. Use this when users want to find specific TV episodes by title or keyword. Episode titles often include the series name followed by the episode name. Results are paginated (10 per page); use the page parameter to navigate results. Search for TV episodes only (excludes movies and full series)

  4. 08

    Search movies

    Returns a paginated list of matching movie titles. Each result includes: Title, Year, IMDb ID, Type (always "movie"), and Poster URL. Use this when users specifically want to find movies (not TV shows) by keyword. Results are paginated (10 per page); use the page parameter to navigate results. Optional year filter narrows results to a specific release year. Search for movies only (excludes TV series and episodes)

Capability set03 / 03

09-12

4 capabilities in this set.

Part of 12 available through OMDb API.

  1. 09

    Search series

    Returns a paginated list of matching series titles. Each result includes: Title, Year (or year range like "2008-2013"), IMDb ID, Type (always "series"), and Poster URL. Use this when users specifically want to find TV shows (not movies) by keyword. Results are paginated (10 per page); use the page parameter to navigate results. Optional year filter narrows results to series that started in a specific year. Search for TV series only (excludes movies and episodes)

  2. 10

    Get by title

    Returns the same fields as get_by_imdb_id: Title, Year, Rated, Runtime, Genre, Director, Writer, Actors, Plot, Ratings (IMDb, Rotten Tomatoes, Metacritic), BoxOffice, Production studio, etc. Use this when you know the title but not the IMDb ID. IMPORTANT: If multiple items share the same title, the API may return the first match or an error. To narrow results, use the optional type filter (movie/series/episode) and year filter. For more precise matching, prefer get_by_imdb_id when available. Get details for a movie or TV series by its exact title

  3. 11

    Get full by imdb ID

    This is the same as get_by_imdb_id but always uses plot="full" for the most comprehensive synopsis. Returns: Title, Year, Rated, Released, Runtime, Genre, Director, Writer, Actors, full Plot, Language, Country, Awards, Ratings (IMDb, Rotten Tomatoes, Metacritic), Metascore, imdbRating, imdbVotes, imdbID, Type, DVD release date, BoxOffice gross, Production studio, and Website. Using IMDb ID is the most accurate method. IDs are unique and unambiguous unlike titles which can have duplicates. The full plot provides deeper synopsis detail compared to the short version. Get the most detailed information for a movie or series using its IMDb ID

  4. 12

    Get multiple by ID

    Each ID is fetched individually and results are combined into one response. If any ID fails, it will be returned with an error message while others still succeed. Use this when comparing multiple films, getting info for a franchise, or batch-processing a list of IMDb IDs. Format: comma-separated IMDb IDs without spaces (e.g., "tt0468569,tt1375666,tt0816692"). Each result includes: Title, Year, Rated, Runtime, Genre, Director, Actors, Plot (short), Ratings, imdbRating, imdbVotes, Type, BoxOffice, Production, and more. Get details for multiple movies/series at once using their IMDb IDs

Observed, not estimated

942ms average. Fast in production.

OMDb API is checked daily against the live service.

Daily averagePeak 1181ms
Aug 20Today
Fastest day
795ms
Slowest day
1181ms
14-day trend
Slowing+15%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 12 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of OMDb API, so you can see the experience inside your AI.

It does not authenticate your account with OMDb API. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

OMDb API Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_sJ5dEoRTHHPejDPTfUwMzYxZrZ7OAjuWZ8fYKiej/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — OMDb API capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "omdb-api-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_sJ5dEoRTHHPejDPTfUwMzYxZrZ7OAjuWZ8fYKiej/mcp"
    }
  }
}
  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Step-by-step instructions for each client are in the guide. How to connect

FAQ

Questions OMDb API owners ask.

  • 01

    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.

  • 02

    Can I get ratings from multiple sources (IMDb, Rotten Tomatoes, Metacritic) at once?

    Yes! Use the get_ratings capability 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 capability also returns the IMDb vote count and Metascore as separate fields.

  • 03

    Can I look up details for multiple movies at the same time?

    Yes! Use the get_multiple_by_id capability 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.

  • 04

    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).

Explore

More in Data Analytics

Suggestions