Vinkius
TMDB

Supercharge your AI with TMDB. Stop searching. Start scripting film metadata retrieval.

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

TMDB (The Movie Database) MCP on Cursor AI Code Editor MCP Client TMDB (The Movie Database) MCP on Claude Desktop App MCP Integration TMDB (The Movie Database) MCP on OpenAI Agents SDK MCP Compatible TMDB (The Movie Database) MCP on Visual Studio Code MCP Extension Client TMDB (The Movie Database) MCP on GitHub Copilot AI Agent MCP Integration TMDB (The Movie Database) MCP on Google Gemini AI MCP Integration TMDB (The Movie Database) MCP on Lovable AI Development MCP Client TMDB (The Movie Database) MCP on Mistral AI Agents MCP Compatible TMDB (The Movie Database) MCP on Amazon AWS Bedrock MCP Support

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.

+ 10 more capabilities included
Discover content by filter

Find movies and TV shows using advanced filters like genre, rating, or release date via the discover_movies tool.

Retrieve core movie metadata

Get detailed information for a single film—plot summary, runtime, director, etc.—using get_movie_details.

Track TV series and seasons

Pull data on an entire show (get_tv_details), specific season details (get_tv_season_details), or individual episodes (get_tv_episode_details).

Lookup people's filmographies

Get a person’s bio and list all the films and shows they were involved in using get_person_details.

Check content ratings

Access official regional certifications for movies or TV series to understand content limitations using dedicated tools.

Compatible AI Apps

OAuth 2.0 Compatible
Vinkius runs on Claude Claude
Vinkius runs on ChatGPT ChatGPT
Vinkius runs on Cursor Cursor
Vinkius runs on Gemini Gemini
Vinkius runs on VS Code VS Code
Vinkius runs on JetBrains JetBrains
Vinkius runs on Vercel Vercel
Vinkius runs on Zendesk Zendesk
+ any other MCP app
Included with Plan

Waiting for input…

AI Agent

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 Vinkius

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

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.

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 TMDB 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 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
TMDB 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 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

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

Built · Hosted · Managed by Vinkius TMDB MCP Server - Movie & TV Metadata Retrieval
Server ID 019e38fc-aadd-72a9-81d5-e1c150e45610
Vinkius Inspector
Compliance Grade A+
Score 100/100
Vinkius Inspector Badge — Score 100/100

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.

Built & Managed by Vinkius 30s setup 13 tools

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