An astronaut overseeing a futuristic data hub
Download PDFMarkdown Version

Connect OMDb API to ChatGPT, Claude and Gemini

Set it up once and it works in ChatGPT, Claude, Cursor, and any other client you love. It all runs safely in the background, so you can relax and focus on what really matters. Get instant access to IMDb ratings, plots, and cast details.

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

Your AI does the work. We keep it safe and sound.

No other AI tool gives you this. Your workflow runs in the client you already love, your account stays protected, and you decide what the agent can and cannot do. It is the whole reason to make the switch.

Each Connector lives inside our infrastructure, the same place where your workflow runs. The three things below are already part of it, working quietly in the background so you never have to think about them. Nothing to add, nothing to set up, nothing to worry about.

A futuristic MCP client docking bay
V8 Isolate01

Each Connector runs inside its own sealed environment.

Each Connector runs inside its own sealed V8 runtime — no access to your files, your system, or other servers. A Connector never sees past its own request.

Kill Switch02

One switch stops every agent. Instantly.

One action deactivates every Connector, revokes every token, and ends every session at once. AI Governance keeps the record.

FinOps per User03

Spending limits that pause instead of surprise.

Every user keeps their own connections and credentials, isolated from everyone else. Anything that would cross your spending limit is held for your approval, not billed.

Three controls, built into the layer your AI connects through.

Curated set · 12 capabilities

We ship only the actions that matter.

Capability set01 / 03

01-04

4 capabilities in this set.

Part of 12 available through OMDb API.

  1. 01

    Get by imdb ID

    This capability fetches complete metadata for a specific title using its unique IMDb ID. It returns everything from cast and crew to box office totals and ratings from IMDb, Rotten Tomatoes, and Metacritic.

  2. 02

    Get episode

    This capability retrieves specific details for a single TV episode. You provide the IMDb ID to get the air date, synopsis, director, and cast for that specific installment.

  3. 03

    Get full by title

    This capability pulls the most detailed information available for a movie or series by its name. It always includes the full-length plot synopsis alongside all other metadata.

  4. 04

    Get ratings

    This capability focuses on critical consensus by pulling scores from IMDb, Rotten Tomatoes, and Metacritic. You can search using a title or an IMDb ID.

Capability set02 / 03

05-08

4 capabilities in this set.

Part of 12 available through OMDb API.

  1. 05

    Get short plot

    This capability provides a concise synopsis for a movie or series. It is the best option when you need a quick summary rather than a long narrative.

  2. 06

    Search

    This capability searches the database for titles matching a keyword. It returns a list of results including the IMDb ID, year, and poster URL.

  3. 07

    Search episodes

    This capability searches specifically for TV episodes. It returns a list of matching episode titles and their corresponding IMDb IDs.

  4. 08

    Search movies

    This capability filters searches to only return movie titles. You can also narrow these results down by a specific release year.

Capability set03 / 03

09-12

4 capabilities in this set.

Part of 12 available through OMDb API.

  1. 09

    Search series

    This capability limits search results to TV series. It allows you to filter by the year a series began.

  2. 10

    Get by title

    This capability looks up a movie or series using its exact name. It provides standard metadata like genre, director, and ratings.

  3. 11

    Get full by imdb ID

    This capability uses an IMDb ID to pull the most comprehensive data set available. It is the most accurate way to get a full plot summary and complete production details.

  4. 12

    Get multiple by ID

    This capability performs a batch lookup for several IMDb IDs at once. It combines the results into a single response, which is useful for comparing multiple films.

Real work

What teams actually run

01

Film Review Research

An agent gathers critical scores and cast lists to help a writer draft a movie review.

02

Franchise Comparisons

A user compares the box office and ratings of different movies in a series using batch IDs.

03

TV Show Tracking

An agent finds specific episode details, including air dates and directors, for a series.

04

Quick Fact Checking

A user asks for a brief plot summary or a content rating during a conversation.

Automate a task

Put OMDb API to work on one thing.

Step-by-step automations your AI runs through this Connector: the workflow, the prompts to start with, and the exact capabilities behind each move.

One connector, every AI

OMDb API works with the most popular AI clients.

These are the most popular clients, each with a step-by-step guide: one link, set up once, with governance and visibility built in. And because everything runs on the MCP standard, the same connection also works in any other compatible client — nothing to rebuild.

ClaudeClaudeChatGPTChatGPTGeminiGeminiPerplexityPerplexityGrokGrokMicrosoft CopilotMicrosoft CopilotCursorCursorVS CodeVS CodeWindsurfWindsurfJetBrainsJetBrainsClineClineLangChainLangChainVercel AI SDKVercel AI SDKLovableLovableZ.aiZ.aiRaycastRaycastQwen CodeQwen CodeKimi CodeKimi CodeLe ChatLe Chat

Building your own app? The connector is yours to use.

You don't need a client to put OMDb API to work: the same hosted connection plugs into your own applications and agent code, with the same governance on every request. Build with it, chat with it — one connection for both.

Observed, not estimated

1052ms average. Fast in production.

OMDb API is checked daily against the live service.

Daily averagePeak 1252ms
Oct 3Today
Fastest day
840ms
Slowest day
1252ms
14-day trend
Improving-6%

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

Guided setup for Claude? Set up OMDb API in Claude and other AIs

See all the AI clients this connector works with ↑

Who it's for

Built for the work OMDb API owners hand off.

This MCP is built for anyone who needs to pull film and television metadata into an AI-driven workflow.

  • 01

    Content Creators

    They hand off the task of gathering ratings and cast lists for reviews or scripts.

  • 02

    Data Analysts

    They use the batch lookup capability to process large lists of film data for comparative studies.

  • 03

    Movie Enthusiasts

    They use the agent to quickly check ratings and plot details without manual searching.

FAQ

Questions OMDb API owners ask.

  • 01

    How much does the OMDb API cost?

    The OMDb API offers a free tier that allows for 1,000 requests per day.

  • 02

    Can I search for specific TV episodes?

    Yes, you can use the search_episodes capability to find specific episodes by title or keyword.

  • 03

    Which rating sites are included in the data?

    The MCP provides ratings from IMDb, Rotten Tomatoes, and Metacritic.

  • 04

    Is it better to search by title or IMDb ID?

    Using the IMDb ID is the most accurate method because IDs are unique and prevent errors caused by duplicate movie titles.

  • 05

    Can I get box office numbers?

    Yes, the capability provides theatrical box office gross figures for movies.

  • 06

    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.

  • 07

    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.

  • 08

    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.

  • 09

    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

Connect OMDb API to Claude, Cursor, ChatGPT & more