MCP *arr Server

Instructions

Implementation Reference

• src/index.ts:292-304 (registration)

  Tool registration and input schema definition for 'radarr_search'. Added to TOOLS array if Radarr client is configured.

    name: "radarr_search",
    description: "Search for movies to add to Radarr",
    inputSchema: {
      type: "object" as const,
      properties: {
        term: {
          type: "string",
          description: "Search term (movie name)",
        },
      },
      required: ["term"],
    },
  },

• src/index.ts:1211-1230 (handler)

  Handler function that executes the radarr_search tool: extracts 'term' argument, calls clients.radarr.searchMovies(term), formats top 10 results as JSON response.

  case "radarr_search": {
    if (!clients.radarr) throw new Error("Radarr not configured");
    const term = (args as { term: string }).term;
    const results = await clients.radarr.searchMovies(term);
    return {
      content: [{
        type: "text",
        text: JSON.stringify({
          count: results.length,
          results: results.slice(0, 10).map(r => ({
            title: r.title,
            year: r.year,
            tmdbId: r.tmdbId,
            imdbId: r.imdbId,
            overview: r.overview?.substring(0, 200) + (r.overview && r.overview.length > 200 ? '...' : ''),
          })),
        }, null, 2),
      }],
    };
  }

• src/arr-client.ts:695-697 (helper)

  RadarrClient.searchMovies method: performs API request to /movie/lookup endpoint with search term, returns SearchResult[].

  async searchMovies(term: string): Promise<SearchResult[]> {
    return this['request']<SearchResult[]>(`/movie/lookup?term=${encodeURIComponent(term)}`);
  }

• src/arr-client.ts:673-697 (helper)

  RadarrClient class definition, including searchMovies method that implements the core search functionality via Radarr API.

  export class RadarrClient extends ArrClient {
    constructor(config: ArrConfig) {
      super('radarr', config);
    }
  
    /**
     * Get all movies
     */
    async getMovies(): Promise<Movie[]> {
      return this['request']<Movie[]>('/movie');
    }
  
    /**
     * Get a specific movie
     */
    async getMovieById(id: number): Promise<Movie> {
      return this['request']<Movie>(`/movie/${id}`);
    }
  
    /**
     * Search for movies
     */
    async searchMovies(term: string): Promise<SearchResult[]> {
      return this['request']<SearchResult[]>(`/movie/lookup?term=${encodeURIComponent(term)}`);
    }

• src/arr-client.ts:426-443 (schema)

  SearchResult interface used by searchMovies method, defines structure of search results including Radarr-specific fields like tmdbId and imdbId.

  export interface SearchResult {
    title: string;
    sortTitle: string;
    status: string;
    overview: string;
    year: number;
    images: Array<{ coverType: string; url: string }>;
    remotePoster?: string;
    // Sonarr specific
    tvdbId?: number;
    // Radarr specific
    tmdbId?: number;
    imdbId?: string;
    // Lidarr specific
    foreignArtistId?: string;
    // Readarr specific
    foreignAuthorId?: string;
  }