Vinkius
TMDb

TMDb MCP for AI. Find movie and TV show data using one conversation.

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

The Movie Database (TMDb) MCP on Cursor AI Code EditorThe Movie Database (TMDb) MCP on Claude Desktop AppThe Movie Database (TMDb) MCP on OpenAI Agents SDKThe Movie Database (TMDb) MCP on Visual Studio CodeThe Movie Database (TMDb) MCP on GitHub Copilot AI AgentThe Movie Database (TMDb) MCP on Google Gemini AIThe Movie Database (TMDb) MCP on Lovable AI DevelopmentThe Movie Database (TMDb) MCP on Mistral AI AgentsThe Movie Database (TMDb) MCP on Amazon AWS Bedrock

Connect to your AI in seconds.

The Movie Database (TMDb) MCP Server lets your AI agent search for movies, TV shows, people, and detailed metadata using established industry data.

You can find plot overviews, cast lists, trailers, top-rated content, and even filter results by genre or studio in a single chat session.

What your AI can do

Get movie credits

Retrieves the complete cast list (with characters) and crew details for a given TMDb movie ID.

Popular tv

Lists currently popular TV series and shows, including season and episode counts.

Find by external id

Looks up a movie, TV show, or person by an external ID like IMDb (e.g., 'tt0137523').

+ 12 more capabilities included
Filter movies by criteria

Run discover_movies to find films based on specific genres, release years, minimum ratings, or production studios.

Lookup content by external ID

Use find_by_external_id when you only have an IMDb ID (like 'tt0111161') and need the corresponding TMDb entry for other tools.

Retrieve full movie details

Get comprehensive metadata, including budget, revenue, runtime, and plot summaries, using get_movie with a specific movie ID.

Map cast and crew roles

Pull complete lists of actors (with characters) and film staff (directors, producers, etc.) via the get_movie_credits tool.

Suggest similar films

Ask for recommendations using get_movie_recommendations, which suggests movies based on a provided title's genre and cast.

Find current popular/trending content

Get real-time lists of what's hot right now by calling popular_movies, popular_tv, or trending for movies, shows, or people.

Included with Plan

Waiting for input…

AI Agent

The Movie Database (TMDb) MCP Server: 15 Tools for Media Discovery

Use these tools to search for films, get technical data, find casts, or discover what's popular right now across movies and TV shows.

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 The Movie Database (TMDb) on Vinkius

Get Movie Credits

Retrieves the complete cast list (with characters) and crew details for a given TMDb movie ID.

Popular Tv

Lists currently popular TV series and shows, including season and episode counts.

Find By External Id

Looks up a movie, TV show, or person by an external ID like IMDb (e.g., 'tt0137523').

Discover Movies

Finds movies using advanced filters for genre, year, rating minimums, studios, and...

Get Genres

Retrieves the complete list of available genre IDs and names for filtering in other...

Get Movie

Gets full metadata—overview, budget, revenue, runtime—for a movie using its specific TMDb ID.

Get Movie Recommendations

Suggests similar movies to a reference film, factoring in genre and cast patterns.

Get Movie Videos

Accesses official trailers, teasers, and clips for a movie ID, providing YouTube...

Popular Movies

Lists currently popular movies globally or by country code.

Search Movies

Searches for movies by title, keyword, or phrase, optionally filtering by release...

Search Multi

Performs a broad search across movies, TV shows, and people using one general query...

Search Tv

Searches for TV series by title or keyword, optionally filtering by first air date year.

Top Rated Movies

Lists the highest-rated movies of all time based on user votes.

Top Rated Tv

Lists the most critically acclaimed TV shows of all time.

Trending

Shows what is currently popular—movies, TV shows, or people—for today or this week.

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 The Movie Database (TMDb), 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 The Movie Database (TMDb). 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 15 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.

Manual research means jumping between four different sites just to build one character bio.

Today, if you need a full profile for a film—the cast list, the crew names (director, writer), and the plot summary—you copy-paste from IMDb. Then you go to Wikipedia to check the genre history, and finally, you visit YouTube to find an official trailer. It’s 15 minutes of clicking through four different sites.

With this server, your agent handles it all in one turn. You ask for a film's full profile, and the combined data from `get_movie` and `get_movie_credits` is returned instantly. No copy-pasting required. You get clean, structured JSON.

The Movie Database (TMDb) MCP Server: Find trailers, credits, and metadata.

Before this server, gathering technical details like the budget or revenue meant clicking into a movie's dedicated page on several sites. You had to manually cross-reference these numbers and hope they were updated. It was messy.

Now, calling `get_movie` gives you all that core metadata—budget, revenue, runtime, etc.—in one place. The data is consistent and ready for your script or article.

What your AI can actually do with this

This MCP Server hooks your AI client up directly to The Movie Database, giving you access to a massive library of movie, TV show, and people metadata. You don't gotta jump between half a dozen sites just to nail down some film facts; your agent handles all that heavy lifting for ya.

When you need to find something fast, your client can run search_multi to search across movies, TV shows, and people using one general query. If you're looking specifically for a title, it runs search_movies for films or search_tv for series, and both of those let you narrow the results by year when needed.

For finding out what's hot right now, you can check what’s trending using the trending tool, which pulls real-time popularity data for movies, TV shows, or people. You also get lists of currently popular films with popular_movies, or a rundown of popular TV series and shows that includes season and episode counts via popular_tv.

If you want to see what's been critically acclaimed over time, call top_rated_movies for the best films ever, or top_rated_tv for the most successful television shows.

If you know a movie or show by an outside ID—like that IMDb code starting with 'tt'—you don't need to search. Just run find_by_external_id, and your agent will grab the corresponding TMDb entry for all other tools. You can also start filtering searches using discover_movies when you know specific criteria, letting you narrow down results by genre, minimum rating, production studio, release year, or keywords.

Need to dig deep into a film? Use get_movie with the TMDb ID to pull all the metadata: the plot overview, budget figures, revenue totals, and total runtime. To map out who played what role, run get_movie_credits, which pulls the full cast list (and specifies their characters) plus every single crew member involved in making the film.

You can also ask for movie recommendations using get_movie_recommendations; it suggests similar films based on a reference title's genre and who starred in it.

To get visual assets, use get_movie_videos to access official trailers, teasers, and clips associated with the film ID, which provides YouTube links. For classification help, you can call get_genres to retrieve the complete list of available genre IDs and names, so you know exactly what filters you're working with.

When you need a broad starting point for filtering, you use discover_movies with advanced controls that let you set minimum ratings, specify studios, or target specific years. These search functions work together to give you tight control over the results. If your query is general and spans multiple types of media—like searching for 'Star Wars' whether it's a movie or a show—you use search_multi to handle the ambiguity in one go.

Built · Hosted · Managed by Vinkius TMDb MCP Server - Discover Movies & TV Shows Metadata
Server ID 019d7612-faa6-7249-ae09-b29eebbebc4a
Vinkius Inspector
Compliance Grade A+
Score 98.33/100
Vinkius Inspector Badge — Score 98.33/100

Questions you might have

How do I find movies similar to one I already watched and loved? +

Use the get_movie_recommendations tool 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 tool 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 tool 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 tool 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 tool 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 tool 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 tool with the IMDb ID (e.g., "tt0111161" for The Shawshank Redemption) and external_source="imdb_id". The tool will return the matching TMDb movie, TV show, or person with the TMDb ID, which you can then use with other tools like get_movie, get_movie_credits, or get_movie_videos. This is essential for cross-referencing between IMDb and TMDb databases.

How do I get genre IDs using the `get_genres` tool? +

Run get_genres(type='movie') first. This returns a comprehensive list of every available movie genre and its unique numerical ID. You must use these returned IDs when calling discover_movies to filter results by multiple genres.

What is the purpose of using the `search_multi` tool? +

It queries movies, TV shows, and people profiles all in one search. Use this when your query isn't specific to one media type—for example, searching 'Christopher Nolan' returns his films and his person profile simultaneously.

What ID format does the `get_movie` tool require? +

It requires the integer TMDb movie ID. This number comes from a prior search or list result, not an external identifier like IMDb's 'tt...' code. Always use find_by_external_id if you only have an IMDb ID.

Built & Managed by Vinkius 30s setup 15 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 15 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.