Search MoviesLABSCO SUMMARY
Uses resources and prompts, not just tools.
Most TMDB wrappers stop at search; exposing a movie as an addressable resource means a client can pull one record into context without a tool call, and the two prompts turn a data lookup into something that produces writing. Small surface, but the shape is more thoughtful than the usual API wrapper.
What it is
An MCP server over the TMDB API that uses all three MCP primitives rather than tools alone. Tools handle the lookups, resources expose TMDB information and a movie record by id, and prompts package two writing tasks — a review in a chosen style with a rating, and a recommendation based on genre and mood.
What you get
- Tools: find movies by title or keyword, retrieve trending movies for a day or a week, and find movies similar to one you name
- Static resources at
tmdb://infofor information about the TMDB API andtmdb://trendingfor the current trending list - A resource template at
tmdb://movie/{id}so any movie record can be read by its identifier - Two prompts: a movie review generated with a specified style and rating, and a personalised recommendation driven by genres and mood
Requirements
A TMDB API key, supplied as TMDB_API_KEY in the env block of your client's configuration; the server reads a .env file only from the folder it is started in, and a client does not start it inside the clone. Node.js v16 or later; npm install and npm run build from a clone, then point the client at build/index.js over stdio. npx @modelcontextprotocol/inspector node build/index.js is the documented way to check it works before wiring it into a client.
Setup effort
Build from source — git clone https://github.com/ShubhanshuSondhiya/MCP-TMDB
USE CASES
01
Identifying a film from a fragment
Search by title or keyword, then open the matching record to confirm it.
02
Seeing what is popular right now
Read the trending list for a day or a week straight out of TMDB.
03
Finding the next thing to watch
Ask for titles similar to one you liked, or use the recommendation prompt with a genre and a mood.
04
Writing about a film
Use the review prompt with a style and a rating so the draft comes back in the register you wanted.
3 tools
Listed in project docs. Your client may show a different list.
Get Trending MoviesGet Similar MoviesBEFORE YOU INSTALL
What to know first
Tools you get
3 tools named in the project's documentation.
Requires
- Node.js (v16 or later)
- npm or yarn
- TMDB API key
- TMDB_API_KEY in your environment
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
You clone and build this one yourself.
Server setup
TERMINAL
git clone https://github.com/ShubhanshuSondhiya/MCP-TMDB
cd MCP-TMDB
npm install
npm run buildMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"tmdb-mcp": {
"command": "node",
"args": [
"<YOUR_PATH_TO_MCP_TMDB>/build/index.js"
],
"env": {
"TMDB_API_KEY": "<YOUR_TMDB_API_KEY>"
}
}
}
}<YOUR_PATH_TO_MCP_TMDB> is the full path of your clone (build/index.js is what npm run build produces). The key has to be set here: the server reads a .env file only from the folder it is started in, and Claude Desktop does not start it inside the clone.
