trending_people
Discover currently popular actors, directors, and other entertainment professionals by retrieving trending people data for daily or weekly analysis.
Instructions
Retrieves trending people (actors, directors, etc.). Input: time_window (required: day|week), page (optional), language (optional ISO 639-1). Output: JSON with paginated trending results. Purpose: Discover currently popular people for trend analysis by AI agents.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| language | No | ||
| page | No | ||
| time_window | Yes |
Implementation Reference
- mcp-tmdb-server.js:683-686 (handler)The asynchronous handler function that implements the core logic of the 'trending_people' tool. It fetches trending persons data from the TMDB API endpoint `/trending/person/${time_window}` using the shared `tmdbFetch` utility, passing optional page and language parameters, and returns the JSON-stringified data wrapped in MCP content format.handler: async ({time_window, page, language}) => { const data = await tmdbFetch(`/trending/person/${time_window}`, {page, language}); return {content: [{type: 'text', text: JSON.stringify(data, null, 2)}]}; }
- mcp-tmdb-server.js:673-682 (schema)The JSON schema for input validation of the 'trending_people' tool. Defines required 'time_window' (enum: day/week), optional 'page' (number >=1), and 'language' (string). Enforces no additional properties.inputSchema: { type: "object", properties: { time_window: {type: "string", enum: ["day", "week"]}, page: {type: "number", minimum: 1}, language: {type: "string"} }, required: ["time_window"], additionalProperties: false },
- mcp-tmdb-server.js:670-687 (registration)The complete tool registration object for 'trending_people' within the 'tools' array. Includes name, description, inputSchema, and inline handler. This object is used by the MCP server's ListTools and CallTool handlers to register and invoke the tool.{ name: "trending_people", description: "Retrieves trending people (actors, directors, etc.). Input: time_window (required: day|week), page (optional), language (optional ISO 639-1). Output: JSON with paginated trending results. Purpose: Discover currently popular people for trend analysis by AI agents.", inputSchema: { type: "object", properties: { time_window: {type: "string", enum: ["day", "week"]}, page: {type: "number", minimum: 1}, language: {type: "string"} }, required: ["time_window"], additionalProperties: false }, handler: async ({time_window, page, language}) => { const data = await tmdbFetch(`/trending/person/${time_window}`, {page, language}); return {content: [{type: 'text', text: JSON.stringify(data, null, 2)}]}; } },