tv_top_rated
Retrieve top-rated TV series to find quality content recommendations. Filter results by page, language, or region for targeted TV show discovery.
Instructions
Retrieves top-rated TV series. Input: page (optional), language (optional ISO 639-1), region (optional ISO 3166-1). Output: JSON with paginated results. Purpose: Access highly rated TV shows for quality content recommendations by AI agents.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| language | No | ||
| page | No | ||
| region | No |
Implementation Reference
- mcp-tmdb-server.js:701-704 (handler)The handler function for the 'tv_top_rated' tool. It fetches top-rated TV series data from the TMDB API endpoint '/tv/top_rated' using the shared tmdbFetch utility, with optional parameters for page, language, and region, and returns the JSON-stringified response wrapped in the MCP content format.handler: async ({page, language, region}) => { const data = await tmdbFetch('/tv/top_rated', {page, language, region}); return {content: [{type: 'text', text: JSON.stringify(data, null, 2)}]}; }
- mcp-tmdb-server.js:696-700 (schema)The input schema for the 'tv_top_rated' tool, specifying an object with optional properties: page (number, minimum 1), language (string), and region (string). No additional properties allowed.inputSchema: { type: "object", properties: {page: {type: "number", minimum: 1}, language: {type: "string"}, region: {type: "string"}}, additionalProperties: false },
- mcp-tmdb-server.js:693-705 (registration)The registration object for the 'tv_top_rated' tool within the tools array. This object defines the tool's name, description, input schema, and handler function, which is used by the MCP server for listing and calling the tool.{ name: "tv_top_rated", description: "Retrieves top-rated TV series. Input: page (optional), language (optional ISO 639-1), region (optional ISO 3166-1). Output: JSON with paginated results. Purpose: Access highly rated TV shows for quality content 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/top_rated', {page, language, region}); return {content: [{type: 'text', text: JSON.stringify(data, null, 2)}]}; } },