OMDb API Connector for AI agents.
12 live capabilities
Fetch movie ratings and plot details for film research.
Waiting for input…
Why people use OMDb API
OMDb API Movie Data for Content Creators
This Connector puts all that data into a single conversation with your agent. You can ask for a full summary, the box office numbers, and the critic scores all at once. It turns a dozen clicks into one simple question.
What Vinkius changes
It turns the Open Movie Database into a searchable knowledge base for your AI.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
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.
- Real-world use case 02
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.
- Real-world use case 03
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.
Complete set · 12capabilities
The complete OMDb API capability set.
These are the exact actions your AI can choose when you ask it to work with OMDb API.
01—04
4 capabilities in this set.
Part of 12 available through OMDb API.
- 01 Capability
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.
- 02 Capability
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.
- 03 Capability
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.
- 04 Capability
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.
05—08
4 capabilities in this set.
Part of 12 available through OMDb API.
- 05 Capability
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.
- 06 Capability
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.
- 07 Capability
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.
- 08 Capability
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.
09—12
4 capabilities in this set.
Part of 12 available through OMDb API.
- 09 Capability
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.
- 10 Capability
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.
- 11 Capability
Search movies
Search for movies only by keyword to filter out TV shows. This is great for narrowing down a specific film search quickly.
- 12 Capability
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.
Set up in minutes
One URL. Then ask OMDb API to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use OMDb API from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_sJ5dEoRTHHPejDPTfUwMzYxZrZ7OAjuWZ8fYKiej/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it OMDb API, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable OMDb API for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_sJ5dEoRTHHPejDPTfUwMzYxZrZ7OAjuWZ8fYKiej/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the OMDb API URL.
- Step 03
Save and start
Save the connection and enable OMDb API in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"omdb-api": {
"url": "https://edge.vinkius.com/vk_preview_sJ5dEoRTHHPejDPTfUwMzYxZrZ7OAjuWZ8fYKiej/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using OMDb API
Open Agent mode in chat and ask: "Using OMDb API, help me...". 12 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"omdb-api": {
"url": "https://edge.vinkius.com/vk_preview_sJ5dEoRTHHPejDPTfUwMzYxZrZ7OAjuWZ8fYKiej/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using OMDb API
Ask Copilot: "Using OMDb API, help me...". 12 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"omdb-api": {
"url": "https://edge.vinkius.com/vk_preview_sJ5dEoRTHHPejDPTfUwMzYxZrZ7OAjuWZ8fYKiej/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using OMDb API
Open Cascade and ask: "Using OMDb API, help me...". 12 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"omdb-api": {
"url": "https://edge.vinkius.com/vk_preview_sJ5dEoRTHHPejDPTfUwMzYxZrZ7OAjuWZ8fYKiej/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using OMDb API
Ask Cline: "Using OMDb API, help me...". 12 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add omdb-api --transport http "https://edge.vinkius.com/vk_preview_sJ5dEoRTHHPejDPTfUwMzYxZrZ7OAjuWZ8fYKiej/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using OMDb API
Ask Claude: "Using OMDb API, show me...". 12 tools are ready
Where the request belongs
Work OMDb API can move forward.
Content creators who need to fact-check movie trivia or data analysts looking to compare film performance across different genres.
Content Creator
Researches cast and plot details for a YouTube script about 90s cinema.
Data Analyst
Compares box office numbers for a series of sequels to find trends.
Reviewer
Pulls multi-source ratings to write a balanced critique of a new TV show.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsIMDB API (Unofficial)
Search movies and TV shows. audit ratings, cast, and metadata via IA.
The Movie Database (TMDb)
Search movies, TV shows, people, get details, cast, trailers, and discover content via TMDb API.
TMDB (The Movie Database)
Access movie, TV show, and actor data. search, discover, and retrieve detailed metadata directly from any AI agent.
Trakt
Track TV shows and movies. search titles, get ratings, discover trending content and manage your watchlist.
TVMaze
Search TV shows, get episode guides, browse schedules, discover cast and crew. no API key required.
Watchmode Streaming Availability
Find where to watch any movie or TV show. search streaming availability across Netflix, Disney+, HBO Max, and 200+ platforms directly from your AI agent.
Bring your own AI
Change the model, client or framework. Keep OMDb API connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about OMDb API.
The practical details behind the request, access and result.
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 capability 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 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.
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.
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).
One connection away
Give your agent a direct line to OMDb API.
Connect OMDb API once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available