Get IMDb/RT/Metacritic ratings
get_ratingsLook up IMDb, Rotten Tomatoes, and Metacritic ratings, awards summaries, and OMDb age ratings by IMDb ID or title with optional year/type to confirm the exact film, show, or episode.
Instructions
Look up IMDb, Rotten Tomatoes and Metacritic ratings, an awards summary and OMDb's own age rating (rated) from OMDb, by IMDb id (preferred, e.g. 'tt0133093') or by title (+ optional year/type). The awards summary is free text (major-award wins/nominations: Oscars, Emmys, Golden Globes, etc.), not a structured count, and covers the whole film/show, or one episode when given an episode's imdb_id, never one person. Prefer get_movie/get_tv when you have a TMDB id: they already include this. Requires OMDB_API_KEY. One of imdb_id or title is required; omitting both returns an error. A no-match lookup is not an error: it returns {found:false, reason}; a refusal (bad key, exhausted daily quota) is. A title lookup resolves to whichever single entry OMDb picks, reports no runner-up, and cannot be validated, so it can silently return a different work of the same name. Checked live: title:'Halloween' with no year returns the 1978 original (tt0077651, IMDb 7.7, RT 97%), not the 2018 film titled exactly the same (tt1502407, IMDb 6.5, RT 79%). Always read back the returned imdb_id/title/year to confirm which work you got, and pass year (and type) whenever you know them. When you only have a title, prefer search_movies/search_tv → get_movie/get_tv: that path matches by imdb_id and also drops an OMDb hit whose release year is more than two years from TMDB's, which this tool's title path cannot do.
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": "get_ratings"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | Restrict a title lookup to this entry type. Checked live: without it, OMDb's title match can silently prefer one type when the same title exists as more than one, e.g. a lookup for 'Chuck' with no `type` returns the 2007 TV series, not the unrelated 2016 movie of the same name, with no signal the movie was ever in contention. Affects only a title lookup; no effect when imdb_id is given (already unambiguous). | |
| year | No | Year, to disambiguate a title. | |
| title | No | Movie/show title (used when imdb_id is absent). | |
| imdb_id | No | IMDb title id. Takes precedence over title when both are given. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||