Supercharge your AI with TMDB. Stop searching. Start scripting film metadata retrieval.
Works with every AI agent you already use
…and any MCP-compatible client
Connect to your AI in seconds.
TMDB (The Movie Database) MCP Server gives your AI agent direct access to massive movie, TV show, and actor metadata.
Instead of searching through web pages or using multiple APIs, you query a single source for details like cast lists, genre filters, release dates, and regional certifications.
It's the quickest way to build scripts that need reliable film knowledge. Your agent can run complex searches—like finding top-rated horror movies from a specific year—and get structured data back instantly.
What your AI can do
Get account details
Retrieves specific account-level data associated with your TMDB credentials.
Get configuration
Pulls system and API configuration settings for the TMDB service.
Discover movies
Searches and filters the database to find movies based on specified criteria like genre or year.
Find movies and TV shows using advanced filters like genre, rating, or release date via the discover_movies tool.
Get detailed information for a single film—plot summary, runtime, director, etc.—using get_movie_details.
Pull data on an entire show (get_tv_details), specific season details (get_tv_season_details), or individual episodes (get_tv_episode_details).
Get a person’s bio and list all the films and shows they were involved in using get_person_details.
Access official regional certifications for movies or TV series to understand content limitations using dedicated tools.
Ask an AI about this
Compatible AI Apps
OAuth 2.0 CompatibleWaiting for input…
TMDB (The Movie Database): 13 Tools for Media Metadata
These tools let your agent perform every action needed—from simple keyword searches to complex, multi-stage data retrieval across movies and TV series.
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 TMDB (The Movie Database) on VinkiusGet Account Details
Retrieves specific account-level data associated with your TMDB credentials.
Get Configuration
Pulls system and API configuration settings for the TMDB service.
Discover Movies
Searches and filters the database to find movies based on specified criteria like...
Create Guest Session
Establishes a temporary, unauthenticated session to start basic interactions with...
Get Movie Certifications
Checks and retrieves official regional content ratings and certifications for a...
Get Movie Details
Fetches all available metadata for one specific film, including plot, cast, and runtime.
Get Person Details
Retrieves detailed biographies and complete work histories (filmography) for any person in the database.
Create Request Token
Generates a fresh, time-limited access token needed for authenticated requests...
Search Movies
Performs a basic text search across the movie database to find titles matching...
Get Tv Certifications
Checks and retrieves official regional content ratings and certifications for a TV...
Get Tv Details
Gets comprehensive metadata about an entire television series, including genre and...
Get Tv Episode Details
Fetches all details—summary, air date, cast—for a single TV episode within a season.
Get Tv Season Details
Provides metadata for an entire season of a TV show, including the episode count and run dates.
Connect to your AI in seconds. 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.
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
Make Your AI Do More
Start with TMDB (The Movie Database), then connect any of our 5,000+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,000+ 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
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by TMDB (The Movie Database). 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
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 13 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.
Finding reliable media metadata shouldn't require ten browser tabs and a spreadsheet.
Today, if you needed to build a catalog of 2023 horror films for an article, you open the site. You use genre filters in one tab, check release dates in another, copy-paste cast names into a third, and finally cross-reference regional ratings using a fourth API key. It's tedious, slow, and prone to human error every single time.
With this MCP server, you tell your agent exactly what you need: 'Give me all top-rated horror movies from 2023.' The agent runs `discover_movies`, filters the list, and then uses `get_movie_details` on each one. You get structured JSON data back in seconds. No tabs open, no copy/pasting needed.
The TMDB MCP Server: Get detailed film metadata from your chat.
Manual research means checking the main movie page for a plot summary, then opening the cast list to get names, and finally navigating to a separate 'Certifications' tab just to know if it's rated PG-13. This is where most people burn hours.
Now? Your agent runs `get_movie_details`. It pulls the synopsis, the runtime, *and* the necessary certification status all at once. You get one reliable data payload that you can immediately use in your script.
What your AI can actually do with this
Yo, check it. This ain't your average web search thing. You connect your AI client to The Movie Database (TMDB) server, and you get direct piping access to massive film metadata. Forget scraping web pages or juggling a dozen different APIs just to figure out what movie or show was good.
You query one spot for everything: cast lists, genre rules, release dates, and regional ratings.
Getting Set Up
First off, you gotta get authenticated. Use create_guest_session if you're just testing out basic interaction with the server. If your script needs to run complex stuff, generate a fresh, time-limited access credential using create_request_token. Before writing any code, pull system details—you can check the API configuration settings with get_configuration, or grab specific account data associated with your credentials via get_account_details.
These tools let you nail down exactly how and where your agent's calls are going to land.
Searching for Content
You got two ways to find something. If you know what you want, use search_movies to run a basic text query across the whole movie title database. For anything more complicated—like 'show me top-rated horror films from 1985'—you gotta hit up discover_movies. This tool lets you filter content using advanced criteria like genre, rating thresholds, or specific release years.
Deep Dive: Movies and Films
Once you find a title, you need the goods. Use get_movie_details to pull every piece of metadata available for that single film; that includes the full plot summary, runtime data, director name, and cast breakdown. If you just need to know if a movie is legal in your area or what it's rated for, check the official regional content ratings with get_movie_certifications.
You can’t get all this info from one place, so these tools keep everything structured.
Tracking TV Series and Episodes
The process changes when you deal with a whole show. Start by getting comprehensive metadata for the entire series using get_tv_details; that pulls in genre data and creator info right away. Next, if you're working on seasonal content, pull the season details—you can use get_tv_season_details to get the episode count and run dates for a specific year of the show.
For granular detail, grab a single TV episode’s summary, air date, and cast list with get_tv_episode_details. And remember, you gotta check official regional content ratings for the whole series using get_tv_certifications.
Researching People
Need to track down an actor or a director? Use get_person_details. This tool retrieves the person's full biography and, more importantly, provides their complete work history—the filmography. Your agent gets a structured list of every movie and show they were involved in, making cast research simple.
By combining these tools—from finding initial titles with discover_movies to tracking down specific episode summaries using get_tv_episode_details, or compiling an actor's entire career via get_person_details—your script gets reliable, structured data instantly. You don't mess around; you just get the facts.
019e38fc-aadd-72a9-81d5-e1c150e45610 Here's how it actually works
The bottom line is: it gives your AI client a dedicated, reliable pipeline to query global movie and TV knowledge without leaving your terminal or IDE.
First, subscribe to the server and provide your TMDB API Read Access Token (v4) within the client settings.
Next, prompt your AI agent with a request—for example, 'Find all sci-fi movies released in 2023.'
The agent executes the necessary tools (discover_movies or search_movies) and returns structured JSON data containing the film's metadata.
Who is this actually for?
Content analysts, data scientists working in media tech, and curriculum developers. You're the person who gets stuck pulling metadata from five different web sources just to build one simple database entry. This server lets you stop wasting time on copy-pasting plot summaries and cast names.
Uses get_movie_details and get_tv_episode_details to verify specific content facts for promotional materials or encyclopedic entries.
Runs bulk queries using discover_movies to gather structured data on genres, release years, and ratings across large datasets.
Integrates specific movie or person metadata into scripts using tools like get_person_details for character validation or background checks.
What Changes When You Connect
Get deep, structured data immediately. Instead of scraping a webpage for cast names, use get_movie_details to pull the full list and roles into your script.
Manage complex content research easily. You can filter by genre and year using discover_movies, giving you reliable lists that simple web searches miss.
Keep track of TV shows properly. Use the dedicated tools—get_tv_details to find the series, then get_tv_season_details for season specifics, and finally get_tv_episode_details for the episode summary.
Validate content legality. Before publishing anything, use get_movie_certifications or get_tv_certifications to check regional rating requirements directly through your agent.
Research people's work history in bulk. If you need to know every movie an actor was in, running get_person_details saves hours of cross-referencing.
See it in action
Building a streaming guide for new users
A content team needs to generate a 'Top 10' list. They start by running discover_movies with filters for 'Comedy' and '2023'. Then, they iterate through the results, calling get_movie_details on each title to grab the runtime and main cast. The agent compiles this structured data into a markdown file ready for publication.
Checking for licensing conflicts
A legal team is building an ad campaign around a TV show. They first use get_tv_details to confirm the series ID, then call get_tv_certifications. This confirms the content rating and regional limits before any creative work starts, preventing costly re-edits.
Cross-referencing talent on a project
A user wants to write an article about a director. They use get_person_details for the director's bio. Then, they take one of the films listed in the bio and run get_movie_details again to get the original plot summary and cast list, ensuring all facts are current.
Finding a specific episode recap
A user remembers a key scene from 'Game of Thrones' Season 4. They use get_tv_details to find the show ID, then call get_tv_season_details for season 4, and finally specify the episode number to run get_tv_episode_details. The agent returns the full summary text instantly.
The honest tradeoffs
Searching by vague terms
Asking the agent 'What's a good sci-fi movie?' This gets too broad and lacks necessary filtering parameters.
Don't ask for vague recommendations. Use discover_movies instead, providing specific filters: genre='Sci-Fi', min_rating=7.0.
Mixing up TV and Movie data
Trying to use get_movie_details when you actually need information about a seasonal TV series.
Always check the content type first. Use get_tv_details for the main show info, then drill down using get_tv_season_details and get_tv_episode_details.
Assuming data structure
Expecting the agent to know which tools are needed when you just say 'Tell me about X'. This fails because context is missing.
Be explicit. If you need cast details, ask: 'Use get_movie_details for this film and provide the full cast list.' Use tool names in your prompt.
When It Fits, When It Doesn't
You should use this server if your task requires accessing structured data about films, TV shows, or people involved in media. Think database lookup: You need a plot summary (use get_movie_details), you need to check ratings (use get_movie_certifications), or you need to filter large groups of content (use discover_movies).
Don't use this if your goal is general knowledge, like 'What was the box office gross last week?' or 'Who directed that documentary I saw on Netflix.' For those things, a web search or a dedicated financial tool works better. Also, don't assume one tool covers everything—if you need both plot details and cast roles, you'll likely have to run get_movie_details AND get_person_details in sequence.
If your core task is content discovery and detail retrieval, this server is the right choice. If you only need a basic title search, search_movies works, but for anything mission-critical, use the dedicated tools.
Questions you might have
How do I search for a movie title using `search_movies`? +
Just ask your agent to 'Search for the film Titanic.' The tool runs a basic text query and returns matching titles. It's fast, but remember that for detailed filtering (like genre or year), you should use discover_movies instead.
Which tool do I use to get actor bios? Is it `get_person_details`? +
Yes, that’s right. Use get_person_details and provide the person's ID or name. It gives you their full bio and a complete list of every film they worked on.
Can I get details for a TV show season using `get_tv_season_details`? +
Absolutely. First, use get_tv_details to find the main series ID. Then, you pass that and the desired season number into get_tv_season_details. This tells you exactly how many episodes are in that season.
What's the difference between `get_movie_details` and `discover_movies`? +
search_movies finds titles by keyword. discover_movies lets you filter results using criteria (genre, rating) to find a whole group of content, giving you more control over your search.
I need certifications—do I use `get_movie_certifications` or something else? +
You must use the dedicated tool: get_movie_certifications. It pulls official rating data specific to movies. If it's a TV show, you have to run get_tv_certifications.
How do I handle authentication or rate limits when using `create_request_token`? +
Your AI client manages token refreshing automatically. When you initiate a query, the agent first handles session setup and ensures your request token is active before calling any data tools. If the token expires or hits a limit, the system prompts you to refresh credentials.
What parameters can I pass to `discover_movies` beyond just genre? +
You can filter by release date range, minimum user rating, and specific cast members. Simply tell your agent what criteria you need—like 'all 80s sci-fi films rated above 7'—and the tool handles the complex parameter mapping.
Beyond a summary, what metadata does `get_tv_episode_details` provide? +
It provides deep specifics including air date, runtime, writer credits, and director names. This level of granularity lets you build out comprehensive research reports for a series' production history.
Can I filter movies by specific genres and ratings? +
Yes! Use the discover_movies tool. 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 tool 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.
We've already built the connector for TMDB. Just plug in your AI agents and start using Vinkius.
No hosting. No infrastructure. No complex setup.
All 13 tools are live and waiting.
You're up and running in seconds.
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.
Built, hosted, and secured by Vinkius. You just connect and go.