Get person filmography
get_person_creditsList the movies and TV shows a person is known for, with cast and crew credits ranked by popularity and optional department filtering to isolate roles like directing.
Instructions
List the movies and TV shows a person is known for (cast roles and crew jobs; adult/softcore titles left out), most popular first, capped to the top 25 of each by default. Talk-show/awards-show guest appearances ('Self'/'Himself'/'Herself', plus any cast credit on a TV talk or news show) and repeat entries for the same title are excluded so the list stays about actual roles. A cameo credited under the person's own name is kept, since TMDB marks it no differently from a real role (checked live: Tom Hanks's top cast row is The Simpsons as 'Tom Hanks (voice)'). A title with several crew jobs (writer AND director AND producer on one film) counts once against the crew cap. Cast entries include a vote_average; crew entries (director, writer, …) do not, so call get_movie/get_tv on the id for a crew credit's own vote_average. Pass department (e.g. 'Directing') to restrict crew to just that role: the reliable way to get someone's complete filmography in one department when their other departments would compete for the same cap. For a handful of very prolific people even that isn't enough (e.g. 50+ directing credits), so raise limit too when department alone still looks short. Use for 'what has this actor/director been in'. This tool has no genre filter; for 'which of X's movies are animated/horror/etc.' use discover_movies, combining with_cast/with_crew/with_people with with_genres. discover_tv can't filter by person at all, so for a person's TV work in one genre, call this tool and check the returned media_type 'tv' entries' genres yourself, e.g. via get_tv_shows. Get the id from search_people.
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": {
"id": "<id>"
},
"name": "get_person_credits"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | TMDB person id (from search_people). | |
| limit | No | Max cast entries and max crew entries to return (each capped separately, 1-100). Raise this for a very prolific person (e.g. a director with 50+ films) when even a department filter leaves more titles than the default cap keeps. | |
| department | No | Restrict crew credits to this department (e.g. 'Directing' for a director's filmography). Without it, a multi-hyphenate's other departments (writing, producing, ...) compete for the same 25-credit cap and can crowd out the department you want. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cast | Yes | ||
| crew | Yes |