tmdb

The TMDB MCP Server provides access to The Movie Database (TMDB) data through the MCP interface. Once running, you can query for movies and retrieve detailed information via the MCP tools exposed by this server. The primary tool exposed is search_movies, which lets you search TMDB by title (and optional year) and paginate results. This enables AI assistants that follow the MCP standard to search the TMDB catalog and present results to users in a structured way. To use it within an MCP-enabled workflow, configure your MCP settings to point at the server and call the search_movies tool with the appropriate parameters (query, year, and page).

Prerequisites:

• Node.js >= 18
• TMDB API key from https://www.themoviedb.org/documentation/api

Installation steps:

1. Clone the repository and install dependencies:

git clone https://github.com/rakeshgangwar/tmdb-mcp-server.git
cd tmdb-mcp-server
npm install

2. Build the server:

npm run build

3. Run the server (example):

# Ensure you have set the TMDB_API_KEY in your environment or in your MCP config
node dist/index.js

4. Configure MCP settings to point to the server (see configuration section in README).

Notes and tips:

• When configuring, set the TMDB_API_KEY environment variable to your TMDB API key. This key is required for all API requests.
• The configuration example uses the path /path/to/tmdb-mcp-server/dist/index.js; replace with the actual built path on your system.
• Ensure you’re running Node.js >= 18 as required by the project.
• If you modify source code, rebuild with npm run build before restarting the MCP server.
• If you encounter API quota issues, check your TMDB plan and apply for a higher quota if needed.
• The server exposes at least the search_movies tool. Depending on future updates, additional tools may be added following the MCP schema.