home / mcp / tmdb mcp server

TMDB MCP Server

Provides access to TMDB data for movies, TV shows, and people via MCP endpoints and tools.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "dervish666-tmdb-mcp-server": {
      "url": "http://localhost:12011/mcp",
      "headers": {
        "PORT": "12011",
        "TMDB_API_KEY": "YOUR_TMDB_API_KEY",
        "TMDB_BASE_URL": "https://api.themoviedb.org/3"
      }
    }
  }
}

You have an MCP server that connects to The Movie Database (TMDB) to fetch movie, TV show, and person information. It lets you search, retrieve detailed metadata, and explore popular or trending content, all accessible through a standardized MCP interface for your AI assistants.

How to use

Connect your MCP client to the TMDB MCP Server at the MCP endpoint and use the available tools to search and retrieve information. You can search for movies and TV shows by title, keywords, or dates, pull detailed information about specific items or people, and explore popular or trending content. Your AI assistant can call the provided tools to build rich responses with metadata such as overviews, cast, and ratings.

Typical usage patterns include: searching for a title to find details, requesting details for a specific movie or person, listing trending content, and fetching popular selections. Use the tools to assemble comprehensive result sets and include related metadata (like cast and crew) in your responses.

How to install

Prerequisites: you need Node.js and npm installed on your system. Ensure you are using a recent LTS version of Node.js.

Step 1: Obtain the MCP server files and place them in a working directory on your machine.

Step 2: Install dependencies.

npm install

Step 3: Create and configure environment variables for TMDB access and server port.

cp .env.example .env
```

```
# Edit the .env file to include your configuration
PORT=12011
TMDB_API_KEY=YOUR_TMDB_API_KEY
TMDB_BASE_URL=https://api.themoviedb.org/3

Additional configuration and startup

To run in development mode, start the server with the development command. For production, build the assets first and then start the server.

npm run dev
```

```
npm run build
npm start

Available tools

searchMovies

Search for movies by title or keywords and receive matching results with metadata such as IDs, titles, release dates, and overviews.

getMovieDetails

Retrieve comprehensive details for a specific movie, including cast, crew, ratings, and synopsis.

getPopularMovies

Get a list of currently popular movies with their metadata.

getTrendingMovies

Fetch movies that are trending either daily or weekly, with associated metadata.

searchTVShows

Search for TV shows by title or keywords and obtain matching results with metadata.

getTVShowDetails

Get detailed information about a specific TV show, including seasons, episodes, cast, and crew.

getPopularTVShows

Retrieve a list of popular TV shows with metadata.

getTrendingTVShows

Fetch trending TV shows on a daily or weekly basis with metadata.

searchPeople

Search for actors, directors, and other professionals by name and retrieve basic profile information.

getPersonDetails

Get detailed information about a person, including filmography and notable works.