Overview
Pass `name` or `id`. A name search ignores case, accents and punctuation; when several people share the name, the best-known (by worldwide encyclopedia coverage) is returned and up to five others appear in `otherMatches` with a film they are known for. No match returns 404.
Films come newest first; films without a recorded year come last. `roles` lists every role the person had on that film, so a writer-director shows both. `role` filters to one role, and `filmsTotal` counts the films matching it. Each film's `id` is its Wikidata id, which Movie Lookup accepts as `id` for the full record.
Credits come from Wikidata (CC0) and are refreshed monthly with Movie Lookup.
Live Test Filmography Skill Skill →
The tool
Once your client is connected to the VerveKit server, this appears in its tool list as FilmographySkill. It is read-only and open-world — it fetches and never mutates anything on your side — so most clients call it without asking you to confirm.
{
"name": "FilmographySkill",
"arguments": {}
}Connecting
One server URL covers every skill in the catalog, including this one. Authorization is OAuth: the client opens a browser once, and there is no key to paste into a config file.
{
"mcpServers": {
"vervekit": {
"url": "https://api.vervekit.com/v1/mcp"
}
}
}https://api.vervekit.com/v1/mcpPer-client setup — Claude, Cursor, VS Code, ChatGPT — is on the MCP setup page.
Arguments
These are the properties on the tool's inputSchema, so a well-behaved client validates them before the call is made. Premium arguments are accepted on every plan but only take effect on plans that include them.
| Argument | Type | Description |
|---|---|---|
nameOptional | string | Person name, e.g. Christopher Nolan. Use name or id length 0–120 |
idOptional | string | Wikidata id of the person, e.g. Q25191 length 0–12 |
roleOptional | string | Only films with this roleanydirectoractorwriterproducercomposercinematographereditordefault any |
limitOptionalPremium | integer | Maximum films to return (1-50) default 10 · range 1–50 |
What the model gets back
The result carries a structuredContent object matching the tool's declared outputSchema, so a client reads fields without parsing prose. status is "ok" and error is null on success; a null field means the value was not available for that input, not that the call failed.
{
"status": "ok",
"error": null,
"data": {
"name": "Christopher Nolan",
"id": "Q25191",
"role": "any",
"count": 10,
"filmsTotal": 21,
"roles": {
"director": 17,
"writer": 15,
"producer": 13,
"actor": 3,
"cinematographer": 3,
"editor": 1
},
"films": [
{
"title": "The Odyssey",
"year": 2026,
"roles": [
"director",
"writer",
"producer"
],
"id": "Q131547207"
},
{
"title": "Oppenheimer",
"year": 2023,
"roles": [
"director",
"writer",
"producer"
],
"id": "Q108839994"
},
{
"title": "Tenet",
"year": 2020,
"roles": [
"director",
"writer",
"producer"
],
"id": "Q63985561"
},
{
"title": "Dunkirk",
"year": 2017,
"roles": [
"director",
"writer",
"producer"
],
"id": "Q21935651"
},
{
"title": "Behind the Scenes",
"year": 2017,
"roles": [
"actor"
],
"id": "Q108257926"
},
{
"title": "Quay",
"year": 2015,
"roles": [
"director"
],
"id": "Q21869743"
},
{
"title": "Interstellar",
"year": 2014,
"roles": [
"director",
"writer",
"producer"
],
"id": "Q13417189"
},
{
"title": "Transcendence",
"year": 2014,
"roles": [
"producer"
],
"id": "Q10384115"
},
{
"title": "Man of Steel",
"year": 2013,
"roles": [
"writer",
"producer"
],
"id": "Q622769"
},
{
"title": "The Dark Knight Rises",
"year": 2012,
"roles": [
"director",
"writer",
"producer"
],
"id": "Q189330"
}
],
"otherMatches": [],
"dataAsOf": "2026-11-22"
}
}
Response fields
Paths are relative to data. Premium fields are absent rather than zeroed on plans that do not include them, so check for presence instead of comparing to 0.
| Field | Type | Example | Description |
|---|---|---|---|
name | string | Christopher Nolan | Person name |
id | string | Q25191 | Wikidata id of the person |
role | string | any | Role filter applied |
count | number | 10 | Number of films returned |
filmsTotal | number | 21 | Number of films matching the role filter |
rolesPremium | object | {…} | Films per role across the whole filmography, e.g. director: 12 |
roles.directorPremium | number | 17 | |
roles.writerPremium | number | 15 | |
roles.producerPremium | number | 13 | |
roles.actorPremium | number | 3 | |
roles.cinematographerPremium | number | 3 | |
roles.editorPremium | number | 1 | |
films | array[10] | Films, newest first | |
films.0.title | string | The Odyssey | Film title |
films.0.year | number | 2026 | Year of first release |
films.0.rolesPremium | array | ["director","writer","producer"] | The person's roles: director, actor, writer, producer, composer, cinematographer or editor |
films.0.id | string | Q131547207 | Wikidata id of the film; pass it to Movie Lookup as id |
otherMatches | array | [] | Other people with the same name, best-known first |
dataAsOf | string | 2026-11-22 | Date the data was last refreshed (YYYY-MM-DD) |
Failure modes
Errors come back as tool errors carrying a sentence the model can act on, not a bare status code. Error handling covers the full list.
| Status | What it means |
|---|---|
400 / 422 | The arguments did not validate. The message names the offending one. |
401 | The OAuth session is invalid or expired — reconnect the server. |
403 | Blocked by a key restriction or an IP allow-list. Never a bad identity. |
404 | This skill is not part of VerveKit. Check the catalog. |
429 | Out of credits, or a brief rate limit. The message tells them apart. |
A call costs 1 credit each time the tool actually runs; a model that reasons about the tool without calling it costs nothing.
Use cases
- Actor and Director Pages
- Build person pages that list every film someone made, newest first, with their role in each.
- Movie Discovery
- Let users jump from a film to everything else its director or lead actor worked on.
- Trivia and Connection Games
- Power six-degrees and who-directed-what games from credits across 450,000 films.
- Recommendation Engines
- Recommend films by following the people behind a viewer's favourites.
Other ways to use Filmography Skill
Set up Filmography Skill on VerveKit, or reach the same source a different way. Your VerveKit account and credits work on all of them — one key, one balance.
Related
More in Entertainment: