TMDB (The Movie Database) Connector for AI agents.
13 live capabilities
Get real-time movie and TV show metadata for your research.
Waiting for input…
Why people use TMDB (The Movie Database)
TMDB for Cinema Metadata Research
This Connector lets you just ask your agent for the info. It pulls the biographies and show details directly into your chat, saving you from the manual hunt.
What Vinkius changes
You get instant access to a massive cinema database through a simple chat interface.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Verifying actor filmographies
A scriptwriter needs to know if an actor was active in a specific year.
- Real-world use case 02
Finding high-rated horror movies
A YouTuber wants to find top-rated horror movies from 2023.
- Real-world use case 03
Summarizing TV seasons
A TV critic needs a summary of a specific season.
Complete set · 13capabilities
The complete TMDB (The Movie Database) capability set.
These are the exact actions your AI can choose when you ask it to work with TMDB (The Movie Database).
01—04
4 capabilities in this set.
Part of 13 available through TMDB (The Movie Database).
- 01 Capability
Get account details
Check your TMDB account information quickly. This helps you confirm your current account status.
- 02 Capability
Get configuration
See your current API configuration details. Use this to verify your connection settings.
- 03 Capability
Get movie certifications
Find out the official ratings for a specific movie. This is great for checking regional age limits.
- 04 Capability
Get movie details
Get the full data for a single film title. It provides everything from summaries to runtime.
05—07
3 capabilities in this set.
Part of 13 available through TMDB (The Movie Database).
- 05 Capability
Get person details
Pull biographies and filmographies for actors and crew. Use this to see an actor's entire career history.
- 06 Capability
Create request token
Generate a new request token for your session. This keeps your interaction with the database active.
- 07 Capability
Search movies
Find movies using simple text search queries. It's the fastest way to locate a specific title.
08—10
3 capabilities in this set.
Part of 13 available through TMDB (The Movie Database).
- 08 Capability
Get tv certifications
Look up official ratings for TV shows. This ensures you have the correct regional content data.
- 09 Capability
Get tv details
Get complete information on a specific TV series. This includes overview data for the whole show.
- 10 Capability
Discover movies
Filter movies based on specific genres, ratings, and dates. It helps you find hidden gems in a crowded category.
11—13
3 capabilities in this set.
Part of 13 available through TMDB (The Movie Database).
- 11 Capability
Create guest session
Start a new guest session for temporary data access. This is useful for quick, one-off queries.
- 12 Capability
Get tv episode details
Pull specific data for a single TV episode. Use this for granular summaries of a specific show's history.
- 13 Capability
Get tv season details
See the breakdown of a specific TV season. This helps you see how many episodes are in a season.
Set up in minutes
One URL. Then ask TMDB (The Movie Database) to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use TMDB (The Movie Database) 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_0C6ugaOyy1juWrhQvmxGhYRbtZlwBy2ZJ6bt7IVF/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 TMDB (The Movie Database), and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable TMDB (The Movie Database) for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_0C6ugaOyy1juWrhQvmxGhYRbtZlwBy2ZJ6bt7IVF/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 TMDB (The Movie Database) URL.
- Step 03
Save and start
Save the connection and enable TMDB (The Movie Database) in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"tmdb-the-movie-database": {
"url": "https://edge.vinkius.com/vk_preview_0C6ugaOyy1juWrhQvmxGhYRbtZlwBy2ZJ6bt7IVF/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 TMDB (The Movie Database)
Open Agent mode in chat and ask: "Using TMDB (The Movie Database), help me...". 13 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"tmdb-the-movie-database": {
"url": "https://edge.vinkius.com/vk_preview_0C6ugaOyy1juWrhQvmxGhYRbtZlwBy2ZJ6bt7IVF/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 TMDB (The Movie Database)
Ask Copilot: "Using TMDB (The Movie Database), help me...". 13 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"tmdb-the-movie-database": {
"url": "https://edge.vinkius.com/vk_preview_0C6ugaOyy1juWrhQvmxGhYRbtZlwBy2ZJ6bt7IVF/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 TMDB (The Movie Database)
Open Cascade and ask: "Using TMDB (The Movie Database), help me...". 13 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"tmdb-the-movie-database": {
"url": "https://edge.vinkius.com/vk_preview_0C6ugaOyy1juWrhQvmxGhYRbtZlwBy2ZJ6bt7IVF/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 TMDB (The Movie Database)
Ask Cline: "Using TMDB (The Movie Database), help me...". 13 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add tmdb-the-movie-database --transport http "https://edge.vinkius.com/vk_preview_0C6ugaOyy1juWrhQvmxGhYRbtZlwBy2ZJ6bt7IVF/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 TMDB (The Movie Database)
Ask Claude: "Using TMDB (The Movie Database), show me...". 13 tools are ready
Where the request belongs
Work TMDB (The Movie Database) can move forward.
This is for the film researcher who needs to verify credits quickly, the content creator building a media app, or the movie buff who wants to deep-dive into TV history without the manual browsing.
Film Researcher
Verifying production credits and actor filmographies for historical accuracy on a Tuesday afternoon.
Content Creator
Gathering metadata for video descriptions or social media posts to keep their feed updated.
Media App Developer
Fetching structured data for prototype testing and database population.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsThe Movie Database (TMDb)
Search movies, TV shows, people, get details, cast, trailers, and discover content via TMDb API.
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 TMDB (The Movie Database) 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 TMDB (The Movie Database).
The practical details behind the request, access and result.
What is the TMDB MCP?
The TMDB MCP is a connector that lets your AI client pull real-time movie, TV show, and actor data from The Movie Database.
Can I use the TMDB MCP to find actor biographies?
Yes, you can ask your agent to pull full biographies and career filmographies for almost any actor or production member.
Does the TMDB MCP work for TV shows too?
It works for both movies and TV shows, including specific details for seasons and individual episodes.
How do I get the ratings for a movie using the TMDB MCP?
You can simply ask your AI agent to check the official ratings or certifications for any specific movie title.
Can the TMDB MCP help with content research?
Absolutely. It's perfect for researching production credits, release dates, and cast lists without manual browsing.
Can I find specific TV episodes with the TMDB MCP?
Yes, you can retrieve summaries and specific details for individual episodes of your favorite TV series.
Can I filter movies by specific genres and ratings?
Yes! Use the discover_movies capability. You can provide genre IDs in with_genres and use other filters like sort_by to find highly-rated content.
How do I get information about a specific actor?
Use the get_person_details capability with the person's unique ID. It will return their biography, place of birth, and other metadata.
Can I see the episodes of a specific TV season?
Absolutely. Use get_tv_season_details by providing the series_id and the season_number. It will list all episodes in that season.
One connection away
Give your agent a direct line to TMDB (The Movie Database).
Connect TMDB (The Movie Database) once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available