mcp -tmdb

This MCP server provides a TMDB (The Movie Database) integration to power AI-assisted querying for movie and TV content. It exposes a set of tools for discovering titles, retrieving details, and checking streaming availability, all powered by TMDB data. You can search for movies and TV shows, fetch trending items, get detailed cast and crew information, view recommendations and similar titles, and look up where to watch content by country. The server is designed to work with AI assistants like Claude, enabling natural language prompts to drive rich TMDB data responses.

To use it, run the MCP server with your TMDB API key configured in the environment. Then integrate it with your client (e.g., Claude Desktop or NanoClaw) by pointing the client’s MCP server entry to the running node process and providing the TMDB_API_KEY via environment variables when needed. Typical interactions include asking for trending movies, requesting details for a specific movie, or asking where to watch a title in a given country. The server returns structured results such as titles, IDs, genres, overviews, cast/crew details, and streaming availability when applicable.

Prerequisites:

• Node.js (v14+ recommended) and npm
• A TMDB API key (free tier available)

Installation steps:

1. Clone the repository

git clone https://github.com/Laksh-star/mcp-server-tmdb.git
cd mcp-server-tmdb

2. Install dependencies

npm install

3. Build the project

npm run build

4. Obtain a TMDB API key and configure it in your environment

export TMDB_API_KEY=your_api_key_here

5. Run the server locally (example)

node dist/index.js

6. Optional: integrate with Claude/Desktop clients by configuring the MCP server entry with the appropriate node path to dist/index.js and the TMDB_API_KEY in env

Notes and tips:

• TMDB_API_KEY is required for all requests. Store it securely and don’t expose it in client-side code.
• The default watch providers country is IN if you query get_watch_providers without specifying a country.
• If you encounter rate limits, consider caching popular queries or staggering requests.
• The server exposes a wide range of tools (search_movies, get_movie_details, get_recommendations, get_similar_movies, search_by_genre, advanced_search, search_by_keyword, search_tv_shows, get_trending, get_trending_tv, search_person, get_person_details). Use them to compose rich prompts for your AI assistant.
• For production deployments, consider running behind a process manager (e.g., pm2) and securely injecting TMDB_API_KEY via environment management.
• The Resources section includes tmdb:///movie/<id> links for quick JSON access to full movie details.