OTT Helper MCP Server

A Model Context Protocol (MCP) server that provides intelligent OTT (Over-The-Top) content recommendations based on IMDB ratings, platform availability, and genre preferences.

Features

• Platform-based Recommendations: Get content recommendations from specific OTT platforms (Netflix, Prime Video, Jio Hotstar, Sony Liv, and more)

• Genre-based Filtering: Find content by genre (action, drama, sci-fi, etc.)

• Rating-based Filtering: Filter content by minimum IMDB rating

• Combined Criteria Search: Search by platform + genre + rating simultaneously

• Content Search: Search for specific titles

• Top-Rated Content: Get the highest-rated content across all platforms

• Detailed Information: Get comprehensive details about specific content

Available Platforms

• Netflix

• Prime Video (prime)

• Jio Hotstar (hotstar)

• Sony Liv (sony)

• Peacock

• Apple TV+

• Hulu

• Disney+

• Zee5

• JioCinema

Available Genres

• Action

• Comedy

• Drama

• Sci-Fi

• Thriller

• Horror

• Romance

• Adventure

• Crime

• Mystery

• Fantasy

• History

• Biography

• Animation

• Documentary

Installation

1. Install dependencies:

npm install

2. Build the project:

npm run build

Usage

With Claude Desktop

1. Add the server to your Claude configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "ott-helper": {
      "command": "node",
      "args": ["/absolute/path/to/OTTHelper/build/index.js"]
    }
  }
}

2. Restart Claude Desktop

3. Use the tools in your conversations to get OTT recommendations

With VS Code or Other Clients

Add the server configuration to your mcp.json file:

{
  "servers": {
    "ott-helper": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/OTTHelper/build/index.js"]
    }
  }
}

Demo Video

Demo Video (MP4)

Available Tools

1. get_recommendations_by_platform_and_rating

Get recommendations filtered by platform and minimum IMDB rating.

Parameters:

• platform (required): OTT platform name

• minRating (required): Minimum IMDB rating (0-10)

• contentType (optional): "movie", "series", or "both"

Example:

Get me action movies on Netflix with rating >= 8

2. get_recommendations_by_genre_and_rating

Get recommendations filtered by genre and minimum IMDB rating.

Parameters:

• genre (required): Genre of content

• minRating (required): Minimum IMDB rating (0-10)

• contentType (optional): "movie", "series", or "both"

Example:

Get me drama movies with rating >= 8

3. get_recommendations_by_criteria

Get recommendations filtered by platform, genre, and rating simultaneously.

Parameters:

• platform (required): OTT platform

• genre (required): Genre

• minRating (required): Minimum rating

• contentType (optional): "movie" or "series"

Example:

Get me sci-fi series on Netflix with rating >= 8

4. get_all_content_on_platform

Get all available content on a specific platform.

Parameters:

• platform (required): OTT platform

• sortByRating (optional): Sort by rating (default: true)

Example:

Get all content available on Prime Video

5. get_top_rated_content

Get the highest-rated OTT content.

Parameters:

• limit (optional): Maximum number of results (default: 10)

• genre (optional): Filter by genre

• contentType (optional): "movie" or "series"

Example:

Get the top 5 rated movies

6. search_content_by_title

Search for content by title.

Parameters:

• title (required): Title or partial title

• exactMatch (optional): Require exact match (default: false)

Example:

Search for "Breaking Bad"

7. get_available_filters

Get all available platforms and genres for filtering.

Example:

What are the available filters?

8. get_content_details

Get detailed information about specific content.

Parameters:

• title (required): Title of the content

Example:

Get details about "Inception"

Architecture

The server consists of:

• src/index.ts: Main MCP server with tool definitions and request handlers

• src/database.ts: Sample OTT content database with movies and series

• tsconfig.json: TypeScript configuration

• package.json: Project dependencies and build scripts

Building and Running

Development mode:

npm run dev

Build:

npm run build

Run built version:

npm start

Sample Data

The server comes with sample data including popular movies and TV series like:

• Breaking Bad

• The Office

• Inception

• Stranger Things

• And more!

You can extend the database by modifying the ottDatabase array in src/database.ts.

Future Enhancements

• Integration with real OTT APIs for live content updates

• User preferences and personalized recommendations

• Watch history tracking

• Rating and review system

• Multi-language support

• Advanced ML-based recommendation algorithms

License

MIT