radarr_get_movies

Instructions

Implementation Reference

• src/arr/mcp-functions.ts:376-413 (handler)

  The core handler function for radarr_get_movies. Fetches movies from Radarr via client.getMovies(), applies an optional title filter, truncates results to a limit, and returns a success response with movie details (id, title, year, status, hasFile, monitored, runtime, tmdbId, imdbId, sizeOnDisk, minimumAvailability, overview).

  async radarrGetMovies(args: {
    filter?: string;
    limit?: number;
  }): Promise<Record<string, unknown>> {
    const client = this.ensureRadarr();
    const limit = args.limit || ARR_PREVIEW_LIMIT;
    try {
      let movies = await client.getMovies();
      if (args.filter) {
        const f = args.filter.toLowerCase();
        movies = movies.filter((m) => m.title.toLowerCase().includes(f));
      }
      return {
        success: true,
        totalMovies: movies.length,
        movies: movies.slice(0, limit).map((m) => ({
          id: m.id,
          title: m.title,
          year: m.year,
          status: m.status,
          hasFile: m.hasFile,
          monitored: m.monitored,
          runtime: m.runtime,
          tmdbId: m.tmdbId,
          imdbId: m.imdbId,
          sizeOnDisk: m.sizeOnDisk,
          minimumAvailability: m.minimumAvailability,
          overview: m.overview ? truncate(m.overview, SUMMARY_PREVIEW_LENGTH) : undefined,
        })),
        showing: Math.min(limit, movies.length),
      };
    } catch (error) {
      return {
        success: false,
        error: error instanceof Error ? error.message : String(error),
      };
    }
  }

• src/arr/tool-registry.ts:66-68 (registration)

  Registration of radarr_get_movies in the ToolRegistry, mapping the tool name to arrFunctions.radarrGetMovies with type-cast argument extraction.

  registry.register("radarr_get_movies", (args) =>
    arrFunctions.radarrGetMovies({ filter: args.filter as string | undefined, limit: args.limit as number | undefined }).then(wrapResponse)
  );

• src/arr/tool-schemas.ts:108-118 (schema)

  Input schema definition for radarr_get_movies. Defines the tool name, description, and inputSchema with optional 'filter' (string) and 'limit' (number, default 200) properties.

  {
    name: "radarr_get_movies",
    description: "List all movies in Radarr with optional title filter",
    inputSchema: {
      type: "object" as const,
      properties: {
        filter: { type: "string", description: "Optional title substring filter" },
        limit: { type: "number", description: "Max results to return (default: 200)", default: 200 },
      },
    },
  },