TMDB (The Movie Database) MCP Server for Mastra AIGive Mastra AI instant access to 13 tools to Create Guest Session, Create Request Token, Discover Movies, and more
GDPR Free for SubscribersMastra AI is a TypeScript-native agent framework built for modern web stacks. Connect TMDB (The Movie Database) through Vinkius and Mastra agents discover all tools automatically. type-safe, streaming-ready, and deployable anywhere Node.js runs.
Ask AI about this MCP Server for Mastra AI
The TMDB (The Movie Database) MCP Server for Mastra AI is a standout in the Knowledge Management category — giving your AI agent 13 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
Geminiimport { Agent } from "@mastra/core/agent";
import { createMCPClient } from "@mastra/mcp";
import { openai } from "@ai-sdk/openai";
async function main() {
// Your Vinkius token. get it at cloud.vinkius.com
const mcpClient = await createMCPClient({
servers: {
"tmdb-the-movie-database": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "TMDB (The Movie Database) Agent",
instructions:
"You help users interact with TMDB (The Movie Database) " +
"using 13 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with TMDB (The Movie Database)?"
);
console.log(result.text);
}
main();
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About TMDB (The Movie Database) MCP Server
Connect your AI agent to The Movie Database (TMDB) to access a world of cinematic information through natural conversation.
Mastra's agent abstraction provides a clean separation between LLM logic and TMDB (The Movie Database) tool infrastructure. Connect 13 tools through Vinkius and use Mastra's built-in workflow engine to chain tool calls with conditional logic, retries, and parallel execution. deployable to any Node.js host in one command.
What you can do
- Search & Discover — Find movies and TV shows using text search or advanced filters like genres, ratings, and release dates via
search_moviesanddiscover_movies. - Deep Metadata — Fetch comprehensive details for movies, TV series, specific seasons, and individual episodes using
get_movie_details,get_tv_details, andget_tv_episode_details. - Cast & Crew — Retrieve detailed biographies and filmographies for actors and production members with
get_person_details. - Certifications & Config — Access official movie/TV certifications and system configurations to understand regional content ratings.
- Account Management — Manage guest sessions and retrieve account-specific details for personalized interactions.
The TMDB (The Movie Database) MCP Server exposes 13 tools through the Vinkius. Connect it to Mastra AI in under two minutes — credentials fully managed, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
All 13 TMDB (The Movie Database) tools available for Mastra AI
When Mastra AI connects to TMDB (The Movie Database) through Vinkius, your AI agent gets direct access to every tool listed below — spanning movies, tv-shows, entertainment, and more. Every call runs in a secure, isolated environment with full audit visibility. Beyond a simple connection, you get real-time monitoring of agent activity, enterprise governance, and optimized token usage.
Create guest session on TMDB (The Movie Database)
Create a new guest session
Create request token on TMDB (The Movie Database)
Create a new request token
Discover movies on TMDB (The Movie Database)
Discover movies by filters
Get account details on TMDB (The Movie Database)
Get TMDB account details
Get configuration on TMDB (The Movie Database)
Get TMDB API configuration
Get movie certifications on TMDB (The Movie Database)
Get movie certifications
Get movie details on TMDB (The Movie Database)
Get details for a specific movie
Get person details on TMDB (The Movie Database)
Get details for a specific person
Get tv certifications on TMDB (The Movie Database)
Get TV certifications
Get tv details on TMDB (The Movie Database)
Get details for a specific TV series
Get tv episode details on TMDB (The Movie Database)
Get details for a specific TV episode
Get tv season details on TMDB (The Movie Database)
Get details for a specific TV season
Search movies on TMDB (The Movie Database)
Search for movies by text
Connect TMDB (The Movie Database) to Mastra AI via MCP
Follow these steps to wire TMDB (The Movie Database) into Mastra AI. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Install dependencies
npm install @mastra/core @mastra/mcp @ai-sdk/openaiReplace the token
[YOUR_TOKEN_HERE] with your Vinkius tokenRun the agent
agent.ts and run with npx tsx agent.tsExplore tools
Why Use Mastra AI with the TMDB (The Movie Database) MCP Server
Mastra AI provides unique advantages when paired with TMDB (The Movie Database) through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add TMDB (The Movie Database) without touching business code
Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation
TypeScript-native: full type inference for every TMDB (The Movie Database) tool response with IDE autocomplete and compile-time checks
One-command deployment to any Node.js host. Vercel, Railway, Fly.io, or your own infrastructure
TMDB (The Movie Database) + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the TMDB (The Movie Database) MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query TMDB (The Movie Database), process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed TMDB (The Movie Database) as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query TMDB (The Movie Database) on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using TMDB (The Movie Database) tools alongside other MCP servers
Example Prompts for TMDB (The Movie Database) in Mastra AI
Ready-to-use prompts you can give your Mastra AI agent to start working with TMDB (The Movie Database) immediately.
"Search for the movie 'Inception'."
"Discover top-rated horror movies from 2023."
"Get the details for season 1 of the TV show with ID 1399."
Troubleshooting TMDB (The Movie Database) MCP Server with Mastra AI
Common issues when connecting TMDB (The Movie Database) to Mastra AI through Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpTMDB (The Movie Database) + Mastra AI FAQ
Common questions about integrating TMDB (The Movie Database) MCP Server with Mastra AI.
How does Mastra AI connect to MCP servers?
MCPClient with the server URL and pass it to your agent. Mastra discovers all tools and makes them available with full TypeScript types.Can Mastra agents use tools from multiple servers?
Does Mastra support workflow orchestration?
Explore More MCP Servers
View all →
Helpwise
7 toolsCollaborate on customer emails, SMS, and WhatsApp messages in shared team inboxes with assignment and automation rules.
USGS Water Services
5 toolsAccess real-time and historical water data from the USGS, including streamflow, groundwater levels, and site metadata across the US.
Widen (Acquia DAM)
10 toolsSearch and manage digital assets, metadata, and CDN embed links on Widen (Acquia DAM) — the leading enterprise DAM solution.
BookingLive
17 toolsAutomate booking and order management via BookingLive — create orders, track statuses, and manage customer reservations directly from your AI agent.