tv_popular
Get popular TV series recommendations using paginated results. Filter by language and region to find shows trending in specific markets.
Instructions
Retrieves popular TV series. Input: page (optional), language (optional ISO 639-1), region (optional ISO 3166-1). Output: JSON with paginated results. Purpose: Access widely popular TV shows for general recommendations by AI agents.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| language | No | ||
| page | No | ||
| region | No |
Implementation Reference
- mcp-tmdb-server.js:737-740 (handler)The handler function that executes the tv_popular tool. It fetches popular TV series data from the TMDB API endpoint '/tv/popular' using the tmdbFetch helper, with optional parameters for page, language, and region, and returns the JSON-stringified data wrapped in MCP content format.handler: async ({page, language, region}) => { const data = await tmdbFetch('/tv/popular', {page, language, region}); return {content: [{type: 'text', text: JSON.stringify(data, null, 2)}]}; }
- mcp-tmdb-server.js:732-736 (schema)The input schema defining the parameters for the tv_popular tool: optional 'page' (number >=1), 'language' (string, ISO 639-1), and 'region' (string, ISO 3166-1).inputSchema: { type: "object", properties: {page: {type: "number", minimum: 1}, language: {type: "string"}, region: {type: "string"}}, additionalProperties: false },
- mcp-tmdb-server.js:729-741 (registration)The complete tool object definition for 'tv_popular' within the tools array, which is later used to register the tool's metadata for listing and its handler for execution in the MCP server request handlers.{ name: "tv_popular", description: "Retrieves popular TV series. Input: page (optional), language (optional ISO 639-1), region (optional ISO 3166-1). Output: JSON with paginated results. Purpose: Access widely popular TV shows for general recommendations by AI agents.", inputSchema: { type: "object", properties: {page: {type: "number", minimum: 1}, language: {type: "string"}, region: {type: "string"}}, additionalProperties: false }, handler: async ({page, language, region}) => { const data = await tmdbFetch('/tv/popular', {page, language, region}); return {content: [{type: 'text', text: JSON.stringify(data, null, 2)}]}; } },