# Watchmode Streaming Availability MCP

> Watchmode Streaming Availability connects your AI client directly to global streaming metadata. Search for any movie or TV show and get real-time availability data—whether it's on Netflix, Disney+, HBO Max, or one of 200+ platforms. It tells you instantly if a title is available to stream, rent, or buy in your specific region.

## Overview
- **Category:** content-management
- **Price:** Free
- **Tags:** streaming, watchmode, movies, tv-shows, netflix, availability, entertainment, metadata

## Description

You're connecting your AI client straight to Watchmode. This isn't just another database; it's a live feed of global streaming metadata. When you need to know if a movie or TV show is available—and where—it tells ya. It handles the whole mess: whether that title streams, rents, or buys in whatever corner of the world you're in. You won't waste time hunting through platform-specific sites.

**Discovering Titles by Name**
Want to know if something exists? You run `search_titles` and get basic metadata for a movie or TV show just by its name. That’s your starting point. Need more background info on that title? Call `get_title_details`. That pulls the plot summary, genre data, and all the associated streaming sources into one call. If you're focused purely on who was involved, use `get_title_cast` to pull the list of actors, directors, and writers for a specific film or series.

**Pinpointing Availability**
You need to know where it plays right now? Use `get_title_sources`. This tool lists every single platform—subscription, rent, buy, or even free—where that title is available. It gives you deep links straight into the service. You can also use `get_title_sources` in conjunction with other tools to verify exactly where the content lives.

**Exploring Catalogs and Platforms**
Sometimes ya don't know what you want, you just need to see what's out there. Use `list_genres` first; it returns an exhaustive list of every genre supported by the whole catalog so you can filter your search properly. Then, run `list_titles` using that genre or source platform, and it browses massive content catalogs for ya. You can also use `list_titles` to filter by region or specific type of content.

Need to check out what's new? Run `list_releases`. It gives you titles that just dropped or are coming up on any connected streaming service. If you wanna see what services operate in a certain place, run `list_sources` against a defined country or region; it lists every active streaming provider for ya. You can even get an exhaustive list of all those available platforms using `list_sources`, optionally filtering by whether they're subscription-based or something else.

Every tool here works together to solve the one problem: figuring out where the content is, and how you gotta watch it. You run `get_title_details` for a full breakdown; you use `get_title_sources` to confirm the exact streaming options; and you hit up `list_titles` when you wanna browse by genre or region instead of searching by title name.

## Tools

### get_title_cast
Pulls the list of actors, directors, and writers for a specific movie or TV title.

### get_title_details
Retrieves all metadata about a title, including its plot summary, ratings, and associated streaming sources.

### get_title_sources
Lists every platform where the title is available right now—subscription, rent, or buy—and provides deep links to those services.

### list_genres
Returns an exhaustive list of all genres supported by the streaming catalog for filtering purposes.

### list_releases
Lists titles that were recently added or are upcoming on any connected streaming platform.

### list_sources
Gives a list of all active streaming services available in a specific country, optionally filtered by type.

### list_titles
Browses through the catalog of titles using filters like genre, source platform, or region.

### search_titles
Quickly searches for a movie or TV show by name and returns basic identifying metadata.

## Prompt Examples

**Prompt:** 
```
Where can I watch 'The Last of Us'?
```

**Response:** 
```
I searched Watchmode and found 'The Last of Us' (TV Series). It's currently available for streaming on Max (HBO), and available for purchase on Apple TV and Amazon Prime Video. Want me to get the direct links?
```

**Prompt:** 
```
List all streaming platforms available in Brazil.
```

**Response:** 
```
I found 45+ streaming services available in Brazil, including Netflix, Disney+, Max, Amazon Prime Video, Globoplay, Apple TV+, and Paramount+. Would you like to search for a specific title on any of these?
```

**Prompt:** 
```
Get the full cast of 'Oppenheimer'.
```

**Response:** 
```
Here's the cast of 'Oppenheimer': Cillian Murphy as J. Robert Oppenheimer, Emily Blunt as Kitty Oppenheimer, Robert Downey Jr. as Lewis Strauss, Matt Damon as Leslie Groves. Directed by Christopher Nolan. Want to see where it's streaming?
```

## Capabilities

### Discover Titles By Name
Run `search_titles` to find basic metadata for a movie or TV show by its name.

### Get Full Title Breakdown
Call `get_title_details` to get the plot, genre data, and all associated streaming sources in one go.

### Determine Streaming Sources
Use `get_title_sources` to list every platform where a specific title is currently available (stream/rent/buy).

### Research Regional Platforms
Run `list_sources` to get an exhaustive list of streaming services operating in a defined country or region.

### Browse Content Catalogs
Use `list_titles` and `list_genres` to filter and browse large catalogs of content by criteria like genre or type.

## Use Cases

### Content Curating a New Series Page
A content curator needs to build a comprehensive page for 'The Last of Us.' Instead of checking HBO, Amazon, and Apple TV individually, they run `get_title_details` followed by `get_title_sources`. The agent returns the plot summary, genre tags, *and* a list of all current streaming options in one structured output. Problem solved.

### Developing a Country-Specific App
An app developer is launching in Mexico and needs to know which services are viable partners. They run `list_sources` for 'Mexico.' The agent returns 45+ service names, allowing the dev team to scope out all potential data integrations before writing any code.

### Tracking a Franchise's History
A media analyst wants to know every title connected to a specific director (e.g., Christopher Nolan). They use `get_title_cast` repeatedly, feeding the cast/crew data back into the agent loop until they have mapped out the entire filmography and its corresponding streaming status.

### Finding Niche Content by Genre
A user knows they want a 'Sci-Fi' movie but doesn't know which titles exist. They run `list_genres` first, confirm the correct genre ID, then use `list_titles` and filter that result to find all Sci-Fi hits available in their region.

## Benefits

- Stop guessing if a title is available. Running `get_title_sources` tells you immediately if it's free streaming, or only available to rent on Apple TV this month.
- Build smarter recommendation logic using `list_genres`. You can filter the entire catalog by genre and then check which specific platforms carry that content via `list_titles`.
- Audit global markets easily. Use `list_sources` with a country code—you instantly get an exhaustive list of every streaming service active in Brazil, Japan, or Germany.
- Get complete character sheets for your data models. Calling `get_title_cast` gives you the full cast and crew roster for any title, eliminating manual research steps.
- Keep up with content trends by running `list_releases`. You can track what titles are newly available across major platforms before they become viral hits.

## How It Works

The bottom line is: you supply the query and the API key; the server returns actionable, real-time streaming metadata.

1. Subscribe to the Watchmode server.
2. Request a free API key from the Watchmode site and paste that key into your agent client.
3. Your AI agent runs a tool (like `get_title_sources`) with specific parameters (e.g., title ID, country code), returning structured data about availability.

## Frequently Asked Questions

**How do I search for a title using `search_titles`?**
You provide the title name. The tool returns basic metadata and IDs, which are necessary identifiers to use in subsequent calls like `get_title_details`. It's always best practice to run this first.

**Can I list all streaming services available in a country using `list_sources`?**
Yes. Running `list_sources(country='US')` gives you an exhaustive, filterable list of every service that operates there, regardless of whether they currently host content.

**What if I want to know the cast for a title? Do I use `get_title_cast`?**
Yes, that's right. The `get_title_cast` tool pulls only the actors and crew details. It keeps your payload clean by separating cast data from general plot information.

**Is there a way to browse titles by genre? Which tool should I use?**
You should start with `list_genres` to confirm the exact genre ID. Then, pass that ID into `list_titles` to filter and retrieve the corresponding catalog of movies or shows.

**What are the rate limits when running searches using tools like `search_titles`?**
The free plan allows 1,000 requests per month. You must first request your API key through the Watchmode portal. This limit applies across all functions, including listing and searching titles.

**If I need comprehensive data (plot, ratings) for a title, should I use `get_title_sources` or `get_title_details`?**
You must use `get_title_details`. While `get_title_sources` only lists the platforms hosting a title, the details tool pulls rich metadata—including plot summaries, ratings, and deep links—in one call.

**How can I filter the catalog of titles beyond just searching by name using `search_titles`?**
Use the `list_titles` tool for detailed filtering. This lets you narrow down results by type, specific streaming source, or target region to build a curated list of content.

**Which tool should I use if I want to track newly released movies and TV shows?**
Use `list_releases`. This tool specifically tracks titles that were recently added or are upcoming across streaming platforms. It provides a view of emerging content, not just currently searchable titles.

**Can I check if 'Inception' is available on Netflix in the US?**
Yes! First use `search_titles` to find the Watchmode ID for 'Inception', then use `get_title_sources` to see all platforms where it's available, including Netflix — with direct links.

**How do I find all streaming services available in France?**
Use the `list_sources` tool with region set to 'FR'. It returns all supported platforms in France, including Canal+, Netflix, Disney+, and more.

**Do I need a credit card for the API key?**
No! Watchmode offers a free plan with 1,000 requests/month that requires no credit card. Just visit api.watchmode.com/requestApiKey to get your key instantly.