Vinkius
OMDb API

OMDb API MCP for AI. Get full movie data and compare all ratings instantly.

Claude Claude
ChatGPT ChatGPT
Cursor Cursor
Gemini Gemini
Windsurf Windsurf
VS Code VS Code
JetBrains JetBrains
Vercel Vercel
See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

OMDb API MCP on Cursor AI Code EditorOMDb API MCP on Claude Desktop AppOMDb API MCP on OpenAI Agents SDKOMDb API MCP on Visual Studio CodeOMDb API MCP on GitHub Copilot AI AgentOMDb API MCP on Google Gemini AIOMDb API MCP on Lovable AI DevelopmentOMDb API MCP on Mistral AI AgentsOMDb API MCP on Amazon AWS Bedrock

Connect to your AI in seconds.

OMDb API MCP Server. Access movie and TV show data using IMDb IDs, titles, or batch lookups. Pull critical details like Rotten Tomatoes scores, full cast lists, box office figures, and plot synopses directly into your workflow via your AI client.

What your AI can do

Get by imdb id

Use this for the most accurate way to get all details about a movie or series if you know its unique IMDb ID.

Get by title

Get details for a film or show when you only know the title, but be careful since titles can match multiple things.

Get episode

Retrieve full metadata for one specific TV episode using its unique IMDb ID.

+ 9 more capabilities included
Retrieve details by unique IMDb ID

You use get_by_imdb_id when you have a unique identifier and need all available metadata for a movie or series.

Get full plot synopses

The agent calls the appropriate function to pull long-form, complete plot details for any title.

Compare multiple sources ratings

You use get_ratings to get IMDb, Rotten Tomatoes, and Metacritic scores side-by-side in a single result.

Batch process multiple titles

Sending a list of IDs via get_multiple_by_id retrieves metadata for several films or shows simultaneously.

Find specific TV episodes

Using the dedicated get_episode tool allows you to pull deep details about one specific season episode.

Included with Plan

Waiting for input…

AI Agent

OMDb API: 12 Tools for Film Metadata Retrieval

These tools let you search, compare, and retrieve every piece of film and TV metadata—from ratings to box office gross—using specific identifiers.

Make your AI actually useful.

Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.

Start using OMDb API on Vinkius

Get By Imdb Id

Use this for the most accurate way to get all details about a movie or series if you know its unique IMDb ID.

Get By Title

Get details for a film or show when you only know the title, but be careful since...

Get Episode

Retrieve full metadata for one specific TV episode using its unique IMDb ID.

Get Full By Imdb Id

Get the most complete data set, including a deep plot summary, by providing an IMDb...

Get Full By Title

Pull all metadata and a full synopsis for a movie or series when you only have its...

Get Multiple By Id

Compare several titles at once by listing multiple IMDb IDs in one request.

Get Ratings

Get all available rating scores (IMDb, Rotten Tomatoes, Metacritic) for a title or series.

Get Short Plot

Fetch a quick, brief summary of the plot for any movie or series by its name.

Search

Search for general titles (movies/series) using keywords and filters to find...

Search Episodes

Find specific TV episodes by title or keyword, returning paginated lists of episode...

Search Movies

Search exclusively for movies using keywords and optional year filters.

Search Series

Find TV series only, returning paginated lists of show titles and their years.

Security and governance baked right in.

Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.

Claude AI

Claude AI

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.

2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.

3

Start a conversation

Open a new chat. The OMDb API integration is available immediately — no restart needed.

Choose How to Get Started

Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.

Build Your Own

Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.

  • Import from OpenAPI, Swagger, or YAML specs
  • Create Agent Skills with progressive disclosure
  • Deploy to edge with MCPFusion framework
  • Built in DLP, auth, and compliance on every call
  • Real time usage dashboard and cost metering
  • Publish to catalog or keep private
Start building

Make Your AI Do More

Start with OMDb API, then connect any of our 5,100+ other servers whenever your AI needs more. One click, no limits.

  • Use this MCP plus 5,100+ others, all in one place
  • Add new capabilities to your AI anytime you want
  • Every connection is secured and compliant automatically
  • Track usage and costs across all your servers
  • Works with Claude, ChatGPT, Cursor, and more
  • New servers added to the catalog every week
OMDb API MCP server cover

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by OMDb API. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

VINKIUS INFRASTRUCTURE

Cloud Hosted

Managed infra

V8 Isolated

Sandboxed per request

Zero-Trust Proxy

No stored credentials

DLP Enforced

Policy on every call

GDPR Compliant

EU data residency

Token Compression

~60% cost reduction

Your data is protected. See how we built it.

Works with Claude, ChatGPT, Cursor, and more

The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.

This connection provides 12 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.

Comparing movie data shouldn't require five different websites.

Right now, if you’re doing film research, you open IMDb for the plot. Then you jump to Rotten Tomatoes for the score. You open Metacritic for critical consensus. If you want box office numbers, that’s another tab. It's a dozen clicks and three different logins just to gather basic comparison metrics.

With this server, your agent handles it all. Give it a list of titles or IDs, and ask for 'all ratings and the plot synopsis.' You get one clean response containing every piece of data you need without ever leaving your chat window.

OMDb API MCP Server: Get movie details by ID

Manual lookups involve copy-pasting titles and then running separate queries for different fields—one query for genre, another for director. This is slow, error-prone, and only gives you partial data.

The `get_by_imdb_id` tool fixes that. You feed it the ID once, and you get a single structured payload containing every piece of metadata available: cast, writer, box office, ratings, plot—all at once.

What your AI can actually do with this

Listen up. This isn't some fancy wrapper; it’s a straight connection to Open Movie Database data for your agent. You pull everything—cast lists, box office numbers, plot synopses, Rotten Tomatoes scores—right into your workflow using just the IMDb ID, title, or keywords. Your AI client handles all the heavy lifting.

Finding What You Need: The Search Tools

Need to start from scratch? Use search when you've got general keywords and want to find potential movie or series titles; it spits out possible IMDb IDs for you. If you know you're looking only for a flick, run search_movies with your keywords and filter by year options. To nail down a TV show, use search_series; that function returns paginated lists of show names and years.

When you need to track down specific episodes, the dedicated search_episodes tool finds them using titles or keywords in paginated batches.

Pinpointing Titles: The Lookup Tools

You got a unique IMDb ID? Use get_by_imdb_id. That's your safest bet because it pulls every bit of metadata for any movie or series without getting confused. If you only know the title, you can use get_by_title, but be warned: titles often match multiple things, so you might get a few options back.

For deep dives, if you have an IMDb ID and need the most complete data set—including a sprawling plot summary—you run get_full_by_imdb_id. If you only know the name but still want all the metadata plus a full synopsis, use get_full_by_title.

Need to compare several titles at once? Just feed multiple IMDb IDs into get_multiple_by_id, and it retrieves the metadata for every single film or show simultaneously. You can also get quick plot summaries using get_short_plot by simply providing a title name.

Focusing on Specific Details: Episodes and Scores

If you're working with TV, use get_episode. This tool lets you pull full metadata for one specific season episode when you already have its unique IMDb ID. To check scores across the board, use get_ratings to get all available rating numbers—IMDb, Rotten Tomatoes, and Metacritic—side-by-side in a single result set.

The Workflow Flow

Your agent can execute these functions together. You start by using search or search_movies to narrow down potential candidates, then use the correct ID getter (get_by_imdb_id) for accuracy. Next, you pull all the detailed info with get_full_by_imdb_id, grab comparative scores via get_ratings, and if it's a show, drill into specific episodes using get_episode.

This server doesn't just give you names; it gives you the whole damn context—the box office gross, the full cast list, and what critics actually thought.

Built · Hosted · Managed by Vinkius OMDb API MCP Server - Movie Data & Ratings
Server ID 019d75e4-3f10-73fe-b709-fdc21d584ea3
Vinkius Inspector
Compliance Grade A+
Score 98.33/100
Vinkius Inspector Badge — Score 98.33/100

Questions you might have

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

What do I need to provide when using the `get_by_imdb_id` tool? +

You must supply a valid IMDb ID string. This unique code is essential because it guarantees that your request points to one specific title, eliminating any guesswork about which movie or show you mean.

Which search tool should I use if I only want to find TV series using `search_series`? +

Use search_series when your goal is exclusively finding whole television shows. This tool filters out movies and single episodes, giving you the overarching metadata for the entire season or franchise.

If I use `get_by_title`, what happens if multiple items share the same name? +

The API may return an error or simply give you the first match it finds. To avoid ambiguity, always try to narrow your search using optional filters for type (movie/series) and year.

What is the necessary workflow when I want details using `get_episode`? +

You can't just search by name; you must first use another tool to get the specific IMDb ID for that episode. The get_episode function requires this unique identifier to pull accurate details like air date and writer.

Built & Managed by Vinkius 30s setup 12 tools

We've already built the connector for OMDb API. Just plug in your AI agents and start using Vinkius.

No hosting. No infrastructure. No complex setup.
All 12 tools are live and waiting. You're up and running in seconds.

Vinkius runs on Claude Claude
Vinkius runs on ChatGPT ChatGPT
Vinkius runs on Cursor Cursor
Vinkius runs on Gemini Gemini
Vinkius runs on Windsurf Windsurf
Vinkius runs on VS Code VS Code
Vinkius runs on JetBrains JetBrains
Vinkius runs on Vercel Vercel
+ other MCP clients

Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.

Zero hosting required Full MCP catalog included Enterprise-grade security Auto-updated by Vinkius

Built, hosted, and secured by Vinkius. You just connect and go.