# Movie Watchlist Analyzer AI Agent Connect

> Movie Watchlist Analyzer lets your AI client dig into your film collections. It calculates total movie counts, breaks down genres, and identifies release decades across your lists. You can also run checks to ensure your data isn't missing titles or years.

## Overview
- **Category:** entertainment
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_LWVOA9XVY13mS4jkzeO4n2Dh0pUIEfSpMPqpYeJ3/ai-agent-connect
- **Tags:** movies, watchlist, statistics, genres, decades

## Description

You can stop manually counting movies or guessing your favorite genres. This MCP gives your AI client the ability to parse through your film watchlists and return specific statistics. If you have multiple lists, your agent can aggregate them to find unique counts or see how your tastes have shifted over time. You can use it to see if you're leaning too heavily into one decade or if a specific genre dominates your collection. It also acts as a data validator. If you've been adding movies haphazardly, your agent can scan the list to find entries that are missing a title or a release year, so you can fix your data before you try to analyze it.

## Tools

### get_watchlist_summary
This tool provides a high level overview of the total number of movies in a list.

### validate_watchlist_completeness
This tool checks your list for any entries that are missing a title or a release year.

### get_decade_breakdown
This tool analyzes the temporal distribution of your movies based on their release decade.

### get_genre_distribution
This tool counts how many movies in a watchlist belong to specific genres, with optional filtering.

## Prompt Examples

**Prompt:** 
```
How many unique movies are in watchlists 'wl-123' and 'wl-456'?
```

**Response:** 
```
There are 45 unique movies across those two watchlists.
```

**Prompt:** 
```
What is the genre distribution for watchlist 'action-fans'?
```

**Response:** 
```
The watchlist contains 12 Action movies, 5 Sci-Fi movies, and 3 Thriller movies.
```

**Prompt:** 
```
Is my watchlist 'my-favorites' complete?
```

**Response:** 
```
Yes, the watchlist is complete with all movies having titles and release years.
```

## Capabilities

### Data Aggregation
Your agent combines multiple watchlists to find total and unique movie counts.

### Genre Profiling
The AI identifies the specific genre makeup of any given list.

### Temporal Analysis
Your agent groups movies into decades to show release trends.

### Data Integrity Checks
The AI scans for missing titles or years to ensure your list is usable.

## Use Cases

### Trend Discovery
Find out if your watchlist is mostly modern films or if you have a heavy concentration of classics.

### List Cleaning
Run a check to find entries that are missing years so you can fix them.

### Genre Auditing
See exactly how many horror or comedy movies you have stored in your lists.

### Collection Comparison
Compare the size and variety of two different watchlists side by side.

## Benefits

- Eliminates manual counting of movie entries.
- Identifies missing data points in your lists automatically.
- Provides instant genre and decade statistics via your AI client.
- Aggregates data across multiple separate watchlists.

## How It Works

Connecting this MCP to your AI client gives your agent immediate access to your movie data.

1. Connect the MCP to your preferred client like Claude or Cursor.
2. Point your agent toward your specific movie watchlists.
3. Ask your agent to run a summary or a genre breakdown.
4. Review the statistical results or data integrity reports provided by the agent.

## Frequently Asked Questions

**What AI clients can I use with this MCP?**
You can use this MCP with any compatible client including Claude, Cursor, Windsurf, and VS Code.

**Can I analyze multiple watchlists at once?**
Yes, you can use the summary tool to find unique movie counts across multiple lists.

**How does it handle missing movie information?**
The validation tool specifically checks for entries that are missing a title or a release year.

**Can I filter genre results?**
Yes, the genre distribution tool allows you to filter by specific genres.

**Does this MCP host my data?**
Vinkius hosts the MCP and manages the connection, allowing your agent to interact with your data through the protocol.

**How can I see the total number of movies in my lists?**
You can use the `get_watchlist_summary` tool by providing the IDs of the watchlists you want to analyze.

**Can I check if my watchlist is missing any data?**
Yes, the `validate_watchlist_completeness` tool checks if any movies are missing a title or a release year.

**How do I see which decades my movies were released in?**
Use the `get_decade_breakdown` tool to get a count of movies grouped by their release decade.