Showtime MCP

An MCP (Model Context Protocol) server that provides tools to search and retrieve information about movies, TV series, actors, and more. Powered by TMDB and OMDB APIs for comprehensive movie data including ratings, streaming availability, and recommendations.

Features

• Movie Search & Discovery - Search movies, discover by genre/year/rating, find trending content
• TV Series Support - Search series, get episode details, season information
• People Search - Find actors, directors, and their complete filmographies
• Recommendations - Get movie and TV recommendations based on what you like
• Collections - Explore movie franchises (Marvel, Harry Potter, etc.)
• Streaming Info - Find where to watch movies (Netflix, HBO, etc.)
• Rich Metadata - Ratings from IMDb, Rotten Tomatoes, Metacritic, plus cast, crew, and images

Getting Started

Prerequisites

• Bun runtime
• API keys for:
  • TMDB (required) - Get one at https://www.themoviedb.org/settings/api
  • OMDB (required) - Get one at https://www.omdbapi.com/apikey.aspx

Installation

1. Clone the repository:

   git clone https://github.com/yourusername/showtime-mcp.git
   cd showtime-mcp

2. Install dependencies:

   bun install

3. Configure environment variables:

   cp .env.example .env

4. Add your API keys to .env:

   OMDB_API_KEY=your_omdb_api_key
   TMDB_API_KEY=your_tmdb_api_read_access_token
   

Adding to Claude Code

Add the following to your Claude Code MCP settings file (~/.claude/settings.json):

{
  "mcpServers": {
    "showtime": {
      "command": "bun",
      "args": ["run", "/path/to/showtime-mcp/src/index.ts"],
      "env": {
        "OMDB_API_KEY": "your_omdb_api_key",
        "TMDB_API_KEY": "your_tmdb_api_read_access_token"
      }
    }
  }
}

Note: Replace /path/to/showtime-mcp with the actual path where you cloned the repository.

After adding the configuration, restart Claude Code for the changes to take effect.

Adding to OpenCode

Add the following to your OpenCode config file (opencode.json in your project or ~/.config/opencode/config.json globally):

{
  "mcp": {
    "showtime": {
      "type": "local",
      "command": ["bun", "run", "/path/to/showtime-mcp/src/index.ts"],
      "env": {
        "OMDB_API_KEY": "your_omdb_api_key",
        "TMDB_API_KEY": "your_tmdb_api_read_access_token"
      }
    }
  }
}

Available Tools

Movie Tools

Tool	Description
search_movies	Search for movies by title
get_movie	Get detailed movie information (ratings, cast, crew, images)
discover_movies	Discover movies by genre, year, rating, actor, or director
get_movie_recommendations	Get movie recommendations based on a specific movie
get_similar	Get similar movies based on genres and keywords
get_collection	Get all movies in a franchise/collection
get_where_to_watch	Find streaming/rental/purchase options for a movie
get_videos	Get trailers, teasers, and behind-the-scenes videos
get_reviews	Get user reviews from the TMDB community
get_now_playing	Get movies currently playing in theaters
get_upcoming	Get upcoming movie releases

TV Series Tools

Tool	Description
search_series	Search for TV series by title
get_series	Get detailed TV series information
discover_tv	Discover TV shows by genre, year, rating, or language
get_season	Get all episodes in a specific season
get_episode	Get details about a specific episode
get_all_episodes	Get all episodes across all seasons
get_tv_recommendations	Get TV recommendations based on a specific show
get_airing_today	Get TV shows with episodes airing today

People & Discovery Tools

Tool	Description
search_person	Search for actors, directors, and crew members
get_person_details	Get biography, birthday, and details about a person
get_filmography	Get a person's complete filmography
get_trending	Get trending movies and TV shows
multi_search	Search movies, TV shows, and people in one request

Example Prompts

Try these prompts to explore what Showtime MCP can do:

Finding Movies

• "Search for movies with 'inception' in the title"
• "Find sci-fi movies from 2023 with a rating above 7"
• "What are the top trending movies this week?"
• "What movies are playing in theaters right now?"
• "What movies are coming out soon?"

Movie Details & Recommendations

• "Get me detailed info about The Shawshank Redemption including cast and ratings"
• "I loved Interstellar, what similar movies would you recommend?"
• "Show me all the movies in the Marvel Cinematic Universe collection"
• "Find movies similar to Inception based on genre"

Trailers & Videos

• "Show me the trailer for Oppenheimer"
• "Get behind-the-scenes videos for Dune Part Two"
• "Find teasers for upcoming Marvel movies"

Reviews

• "Show me reviews for Dune Part Two"
• "What do people think about The Bear?"
• "Get user reviews for Oppenheimer"

Streaming & Watch Options

• "Where can I stream Oppenheimer?"
• "Is Dune available on Netflix?"

TV Series

• "Search for TV series about dragons"
• "Get details about Breaking Bad including total seasons"
• "Show me all episodes of Stranger Things season 4"
• "I just finished The Bear, what similar shows should I watch?"
• "Find Korean drama series with high ratings"
• "What TV shows have new episodes airing today?"

Actors & Directors

• "Find movies directed by Christopher Nolan"
• "What movies has Florence Pugh been in recently?"
• "Show me Leonardo DiCaprio's filmography sorted by rating"
• "Tell me about Timothée Chalamet's biography and career"
• "When was Margot Robbie born and where is she from?"

Discovery & Multi-Search

• "Find highly-rated Korean movies"
• "What horror movies came out in 2024?"
• "Show me comedy movies with Ryan Gosling"
• "Search for 'breaking' across movies, TV shows, and people"
• "Discover crime dramas from 2023 with rating above 8"

Development

# Install dependencies
bun install

# Run type checking
bun run typecheck

# Start the MCP server (for testing)
bun run start

License

MIT