wizzy-mcp-tmdb

Instructions

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)}]};
      }
  },