The Movie Database (TMDb) Connector for AI agents.
15 live capabilities
Access a massive library of movie metadata and TV show details.
Waiting for input…
Why people use The Movie Database (TMDb)
The Movie Database (TMDb) for Accurate Film Metadata
With this Connector, that manual digging disappears. Your agent pulls all that data into a single conversation. You get a clean summary of production details, cast lists, and direct video links instantly. You stop clicking and start knowing.
What Vinkius changes
You get a live, searchable entertainment database hooked directly into 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
Finding Cast for a Video Essay
A content creator asks the agent to find the full cast for Inception and get the official trailer links to include in their script.
- Real-world use case 02
Planning a Movie Night
A user asks for popular horror movies from the 1990s with a rating over 8 to find something high-quality to watch.
- Real-world use case 03
Production Fact Checking
A researcher needs to know the exact production budget and studio for the latest Marvel movie to include in a report.
Complete set · 15capabilities
The complete The Movie Database (TMDb) capability set.
These are the exact actions your AI can choose when you ask it to work with The Movie Database (TMDb).
01—04
4 capabilities in this set.
Part of 15 available through The Movie Database (TMDb).
- 01 Capability
Get genres
Retrieve the full list of movie and TV genres along with their unique IDs. Use these IDs to filter your movie searches.
- 02 Capability
Get movie
Pull every available detail for a movie from runtime to budget. It provides a complete metadata snapshot for any specific title.
- 03 Capability
Get movie credits
Get a full list of actors and their characters for a specific movie. This capability also provides details on the director, producers, and other key crew members.
- 04 Capability
Get movie recommendations
Get a list of similar movies based on a specific title. This uses a dedicated algorithm to find content you will actually enjoy.
05—08
4 capabilities in this set.
Part of 15 available through The Movie Database (TMDb).
- 05 Capability
Get movie videos
Fetch YouTube links for official trailers, teasers, and behind the scenes clips. It provides direct access to promotional content.
- 06 Capability
Popular movies
See a list of the most popular movies currently trending in specific regions. It helps you identify what is hot right now.
- 07 Capability
Popular tv
See which TV shows are currently trending based on user activity. It includes show names, first air dates, and overview descriptions.
- 08 Capability
Search movies
Search the database for movies using titles, keywords, or specific release years. It returns titles, dates, and overviews.
09—12
4 capabilities in this set.
Part of 15 available through The Movie Database (TMDb).
- 09 Capability
Search multi
Search for movies, TV shows, and people at the same time in a single query. This is ideal for broad entertainment searches.
- 10 Capability
Discover movies
Filter movies by very specific criteria like studio, year, and minimum rating. It helps you find niche content quickly.
- 11 Capability
Search tv
Look up TV shows by name, keyword, or first air date. It returns episode counts and overview descriptions for each series.
- 12 Capability
Top rated movies
Find the highest-rated movies of all time based on user votes. This helps you identify the critically acclaimed classics.
13—15
3 capabilities in this set.
Part of 15 available through The Movie Database (TMDb).
- 13 Capability
Find by external id
Convert IMDb or TVDb IDs into TMDb entries. This is perfect for linking different databases together.
- 14 Capability
Top rated tv
Find the most critically acclaimed TV series ever made. It provides a list of the highest-rated shows based on user ratings.
- 15 Capability
Trending
See what content is currently hot today or this week across all media types. This includes movies, TV shows, and people.
Set up in minutes
One URL. Then ask The Movie Database (TMDb) to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use The Movie Database (TMDb) 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_PwpTsQbfR9xNdl8ZJhMlsLyVzRo7NqNWmg3ZzOR6/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 The Movie Database (TMDb), and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable The Movie Database (TMDb) for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_PwpTsQbfR9xNdl8ZJhMlsLyVzRo7NqNWmg3ZzOR6/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 The Movie Database (TMDb) URL.
- Step 03
Save and start
Save the connection and enable The Movie Database (TMDb) in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"the-movie-database-tmdb": {
"url": "https://edge.vinkius.com/vk_preview_PwpTsQbfR9xNdl8ZJhMlsLyVzRo7NqNWmg3ZzOR6/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 The Movie Database (TMDb)
Open Agent mode in chat and ask: "Using The Movie Database (TMDb), help me...". 15 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"the-movie-database-tmdb": {
"url": "https://edge.vinkius.com/vk_preview_PwpTsQbfR9xNdl8ZJhMlsLyVzRo7NqNWmg3ZzOR6/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 The Movie Database (TMDb)
Ask Copilot: "Using The Movie Database (TMDb), help me...". 15 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"the-movie-database-tmdb": {
"url": "https://edge.vinkius.com/vk_preview_PwpTsQbfR9xNdl8ZJhMlsLyVzRo7NqNWmg3ZzOR6/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 The Movie Database (TMDb)
Open Cascade and ask: "Using The Movie Database (TMDb), help me...". 15 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"the-movie-database-tmdb": {
"url": "https://edge.vinkius.com/vk_preview_PwpTsQbfR9xNdl8ZJhMlsLyVzRo7NqNWmg3ZzOR6/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 The Movie Database (TMDb)
Ask Cline: "Using The Movie Database (TMDb), help me...". 15 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add the-movie-database-tmdb --transport http "https://edge.vinkius.com/vk_preview_PwpTsQbfR9xNdl8ZJhMlsLyVzRo7NqNWmg3ZzOR6/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 The Movie Database (TMDb)
Ask Claude: "Using The Movie Database (TMDb), show me...". 15 tools are ready
Where the request belongs
Work The Movie Database (TMDb) can move forward.
This is for anyone who spends too much time researching media or needs to pull accurate film data for work. It's for the cinephile who wants to know every credit on a film and the content creator who needs to cite metadata quickly.
Content Creator
Pulls cast lists and trailer links for video essays or social media posts.
Movie Reviewer
Fetches production budgets and studio info to provide context for film reviews.
Media Researcher
Finds trending titles and genre breakdowns for market analysis or trend reporting.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsTMDB (The Movie Database)
Access movie, TV show, and actor data. search, discover, and retrieve detailed metadata directly from any AI agent.
OMDb API
Search movies & TV shows, get ratings, cast, plot details, and IMDb data via the Open Movie Database API.
IMDB API (Unofficial)
Search movies and TV shows. audit ratings, cast, and metadata via IA.
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 The Movie Database (TMDb) 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 The Movie Database (TMDb).
The practical details behind the request, access and result.
Can the Movie Database (TMDb) MCP find specific cast members?
Yes, it pulls full cast and crew lists for any movie or TV show. You can get details on actors, their characters, and the people behind the scenes like directors and producers.
Does the Movie Database (TMDb) MCP include trailer links?
Yes, it fetches official YouTube links for trailers, teasers, and behind the scenes clips directly from the database.
Can I use the Movie Database (TMDb) MCP to find trending shows?
Yes, it provides live data on what is currently trending today or this week across movies, TV shows, and people.
How does the Movie Database (TMDb) MCP handle IMDb IDs?
It can convert IMDb IDs and other external identifiers into TMDb entries, making it easy to link data between different entertainment databases.
Can the Movie Database (TMDb) MCP filter by studio?
Yes, you can discover movies by specific production studios like Warner Bros or Marvel Studios using the advanced discovery capabilities.
Is the Movie Database (TMDb) MCP good for finding high-rated TV shows?
Absolutely. It has a dedicated capability to retrieve the highest-rated TV shows of all time based on user ratings and popularity.
How do I find movies similar to one I already watched and loved?
Use the get_movie_recommendations capability with the TMDb ID of the movie you loved. TMDb's algorithm analyzes genre, keywords, cast, crew, and user rating patterns to suggest films you're likely to enjoy. For example, if you loved The Dark Knight (ID: 155), the capability will recommend similar superhero and crime thrillers. You can find the TMDb ID by first using search_movies with the title.
Can I filter movies by a specific studio like Warner Bros. or Marvel?
Yes! Use the discover_movies capability with the with_companies parameter. Studio IDs include: 17 (Warner Bros.), 420 (Marvel Studios), 33 (Universal Pictures), 2 (Walt Disney Pictures), 5 (Columbia Pictures), 12 (New Line Cinema). You can combine with other filters like genre, year, or minimum rating. For example: genre="878" (Sci-Fi), with_companies="420" returns all Marvel sci-fi movies sorted by popularity.
Can I watch trailers directly through this integration?
The get_movie_videos capability retrieves all official trailers, teasers, and promotional videos for any movie. Each result includes a YouTube video key. You can watch the trailer by visiting https://www.youtube.com/watch?v={key}. The capability returns videos sorted by type (Trailer, Teaser, Behind the Scenes) with resolution and official status information.
How can I find what movies are trending right now?
Use the trending capability with media_type="movie" and time_window="day" for today's trending movies, or time_window="week" for this week's trends. You can also use media_type="all" to see mixed results (movies, TV shows, and people) or media_type="tv" for trending series. Results include popularity scores, vote averages, and poster images.
Can I convert an IMDb ID to a TMDb entry?
Yes! Use the find_by_external_id capability with the IMDb ID (e.g., "tt0111161" for The Shawshank Redemption) and external_source="imdb_id". The capability will return the matching TMDb movie, TV show, or person with the TMDb ID, which you can then use with other capabilities like get_movie, get_movie_credits, or get_movie_videos. This is essential for cross-referencing between IMDb and TMDb databases.
One connection away
Give your agent a direct line to The Movie Database (TMDb).
Connect The Movie Database (TMDb) once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available