home / mcp / wizzy mcp tmdb server

Wizzy MCP TMDB Server

The wizzy-mcp-tmdb project is an MCP (Model Context Protocol) server implemented in JavaScript that provides tools to search and retrieve information from The Movie Database (TMDB). It allows AI clients to access movie, TV show, and person data through a standardized protocol.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "drakonkat-wizzy-mcp-tmdb": {
      "command": "node",
      "args": [
        "mcp-tmdb-server.js"
      ],
      "env": {
        "TMDB_AUTH_TOKEN": "YOUR_TNL_PROXY_BEARER_TOKEN"
      }
    }
  }
}

You have a JavaScript MCP server that exposes TMDB data through a standardized MCP interface. It lets you search movies, TV shows, and people; fetch detailed item data; and retrieve trending content, all accessible to MCP clients like IDEs or chat bots.

How to use

You integrate this server with your MCP client to access TMDB data. Start the server locally or connect to it from your MCP-enabled toolchain. Use the available tools to search for media, pull detailed information about a specific item, and retrieve current trending content across all media types.

How to install

Prerequisites you need before installation are a recent Node.js runtime and a TMDB API key configured for the proxy you use.

Step 1: Install Node.js (version 18 or higher) and verify it is accessible from your shell.

Step 2: Clone the project to your development machine and move into the project directory.

Step 3: Install dependencies using npm.

Step 4: Set your TMDB bearer token in your environment.

Step 5: Start the MCP server.

Code and config examples

{
  "mcpServers": {
    "tmdb": {
      "command": "node",
      "args": ["mcp-tmdb-server.js"],
      "env": {
        "TMDB_AUTH_TOKEN": "YOUR_TNL_PROXY_BEARER_TOKEN"
      },
      "alwaysAllow": [
        "get_watch_providers",
        "discover_tv",
        "discover_by_provider"
      ]
    }
  }
}

Available tools

search_tmdb

Search TMDB across movies, TV shows, and people using a single query and options for pagination and language.

get_tmdb_details

Fetch detailed information for a specific TMDB item by type (movie, tv, person) with optional append parameters for related data.

trending_all

Retrieve trending content across all media types with configurable time window and language.