Search streaming/rental providers
search_watch_providersResolve a streaming, rental, or purchase service name to its TMDB numeric provider ID for a given country, so you can filter discover results by that provider.
Instructions
Resolve a streaming/rental/purchase service's name (e.g. 'Netflix', 'Disney Plus') to its TMDB numeric provider id. Feed the id into discover_movies/discover_tv's with_watch_providers, with the same watch_region, to find top titles on that service. TMDB has no name-based lookup for this, only numeric ids, and there are hundreds of providers (296 in the US), so don't guess an id. A provider's id, and whether it's offered at all, can differ by country (checked live: Amazon Prime Video is 9 in the US, Germany and Japan but 119 in France, India and Brazil), so search in the country you'll filter in.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>",
"media_type": "<media_type>"
},
"name": "search_watch_providers"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | 1-based page number for pagination (TMDB returns up to 20 results per page, max 500). | |
| query | Yes | Service name (or part of it) to look up, e.g. 'Netflix'. | |
| media_type | Yes | Whether to search movie or TV providers. A service can be offered for one media type but not the other (its id stays the same either way; a movie-only or TV-only service just returns nothing from the wrong media_type). | |
| watch_region | No | The user's country (pass it when known), whose provider list to search; discover_* defaults its watch_region to the same country. A service not offered there comes back as no match, so retry with another country before concluding it doesn't exist. | US |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | Yes | ||
| results | Yes | ||
| total_pages | Yes | ||
| total_results | Yes |