TM

TMDB MCP Server

Model Context Protocol Server

Streamable HTTP Endpoint

Access TMDB Data via MCP

A powerful Model Context Protocol server that provides AI agents with seamless access to The Movie Database (TMDB) API for movies, TV shows, and trending content.

MCP Endpoint

http://localhost:3000/api/mcp

This is a streamable HTTP endpoint that follows the Model Context Protocol specification. Configure your AI agent or IDE to connect to this endpoint to enable TMDB tools.

Available Tools

searchMovies

Search for movies by title with language support

querylanguage

getMovieDetails

Get detailed information about a specific movie

movieIdlanguage

getTrending

Get trending movies, TV shows, or people

mediaTypetimeWindow

discoverMovies

Discover movies by various filters

genreyearlanguagesortBy

searchTVShows

Search for TV shows by title with language support

querylanguage

getTVShowDetails

Get detailed information about a specific TV show

seriesIdlanguage

Installation Instructions

C

Claude Desktop

Official Claude desktop app

  1. Open Claude Desktop settings
  2. Navigate to Developer → MCP Servers
  3. Add a new server configuration:
{
  "mcpServers": {
    "tmdb": {
      "transport": {
        "type": "http",
        "url": "http://localhost:3000/api/mcp"
      }
    }
  }
}
  1. Restart Claude Desktop to apply changes
Cu

Cursor

AI-powered code editor

  1. Open Cursor settings (Ctrl/Cmd + ,)
  2. Go to MCP Servers section
  3. Add the following configuration:
{
  "tmdb": {
    "transport": {
      "type": "http",
      "url": "http://localhost:3000/api/mcp"
    }
  }
}
  1. Restart Cursor to activate the MCP server
W

Windsurf

AI-first IDE by Codeium

  1. Open Windsurf settings
  2. Navigate to Extensions → MCP Servers
  3. Add new HTTP MCP server:
Server Name: tmdb
Transport Type: HTTP
Endpoint URL: http://localhost:3000/api/mcp
  1. Click Connect to verify the connection
Cl

Cline (VS Code Extension)

Autonomous coding agent for VS Code

  1. Install Cline extension from VS Code marketplace
  2. Open Cline settings (Settings → Extensions → Cline)
  3. Configure MCP servers in your settings.json:
{
  "cline.mcpServers": {
    "tmdb": {
      "transport": {
        "type": "http",
        "url": "http://localhost:3000/api/mcp"
      }
    }
  }
}
  1. Reload VS Code window to apply changes
Co

Continue.dev

Open-source AI autopilot for VS Code & JetBrains

  1. Install Continue extension for your IDE
  2. Open Continue config file (~/.continue/config.json)
  3. Add MCP server configuration:
{
  "mcpServers": [
    {
      "name": "tmdb",
      "transport": {
        "type": "http",
        "url": "http://localhost:3000/api/mcp"
      }
    }
  ]
}
  1. Restart the IDE to load the MCP server
GPT

OpenAI ChatGPT

Configure custom MCP servers in ChatGPT

Note: ChatGPT MCP integration requires the desktop application and may have specific requirements for HTTP endpoints.

  1. Open ChatGPT Desktop settings
  2. Go to Model Context Protocol
  3. Add server via HTTP transport with URL:
http://localhost:3000/api/mcp

Quick Start

1

Start the Server

Run the development server to make the MCP endpoint available:

bun run dev
2

Configure Your AI Agent

Follow the installation instructions above for your preferred AI agent or IDE

3

Start Querying TMDB

Use the available tools to search movies, get details, discover content, and more!

Features

Fast & Efficient

Streamable HTTP endpoint for real-time responses without state management overhead

Multi-Language

Support for multiple languages with ISO 639-1 language codes

Type-Safe

Built with TypeScript for reliable tool definitions and parameter validation