rottentomatoes_browse_movies
Browse Rotten Tomatoes movie results by list and filters. Use rottentomatoes_browse_filters for the selected list's valid filters; multi-value filters accept comma-separated values. Resume with after from page_info.end_cursor; limit defaults to 10, capped at 30. Use rottentomatoes_search for a title-name query.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "rottentomatoes_browse_movies"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| list | No | Movie browse list: movies_in_theaters, movies_at_home, movies_coming_soon. Documented values: movies_in_theaters, movies_at_home, movies_coming_soon. | |
| sort | No | Sort value from the selected list's browse/filters response. Documented values: popular, newest, top_box_office, a_z, critic_highest, critic_lowest, audience_highest, audience_lowest. | |
| after | No | Opaque next-page cursor returned in data.page_info.end_cursor | |
| limit | No | Rows to return, default 30 (one full page), max 30. The cursor always moves past the whole 30-row page, so keep the default when paging | |
| genres | No | Comma-separated genre values from browse/filters. Documented values: action, adventure, animation, anime, biography, comedy, crime, documentary, drama, entertainment, faith_and_spirituality, fantasy, game_show, lgbtq, health_and_wellness, history, holiday, horror, house_and_garden, kids_and_family, music, musical, mystery_and_thriller, nature, news, reality, romance, sci_fi, short, soap, special_interest, sports, stand_up, talk_show, travel, variety, war, western. | |
| critics | No | Comma-separated Tomatometer values from browse/filters. Documented values: certified_fresh, fresh, rotten. | |
| ratings | No | Comma-separated content ratings from browse/filters. Documented values: g, pg, pg_13, r, nc_17, nr, ur. | |
| audience | No | Comma-separated Popcornmeter values from browse/filters. Documented values: verified_hot, upright, spilled. | |
| affiliates | No | Comma-separated streaming/service values from browse/filters. Documented values: theaters, fandango, apple-tv-plus, netflix, prime-video, disney-plus, max, peacock, hulu, paramount-plus, amc-plus, acorn-tv, apple-tv. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | The tool result payload (shape varies per tool; see each tool's docs resource). |