sonarr_review_setup

Instructions

Implementation Reference

• src/index.ts:189-196 (registration)

  Tool registration for sonarr_review_setup. Defined as part of the addConfigTools() helper which dynamically creates config review tools for each configured service.

    name: `${serviceName}_review_setup`,
    description: `Get comprehensive configuration review for ${displayName}. Returns all settings for analysis: quality profiles, download clients, naming, storage, indexers, health warnings, and more. Use this to analyze the setup and suggest improvements.`,
    inputSchema: {
      type: "object" as const,
      properties: {},
      required: [],
    },
  }

• src/index.ts:189-196 (schema)

  Input schema for sonarr_review_setup. Has an empty schema (no parameters required) since it returns a comprehensive review of all settings.

    name: `${serviceName}_review_setup`,
    description: `Get comprehensive configuration review for ${displayName}. Returns all settings for analysis: quality profiles, download clients, naming, storage, indexers, health warnings, and more. Use this to analyze the setup and suggest improvements.`,
    inputSchema: {
      type: "object" as const,
      properties: {},
      required: [],
    },
  }

• src/index.ts:1335-1436 (handler)

  Handler for sonarr_review_setup (and radarr_review_setup, lidarr_review_setup). Gathers all configuration data: status, health, quality profiles, quality definitions, download clients, naming, media management, root folders, tags, and indexers, then returns a comprehensive JSON review.

  case "sonarr_review_setup":
  case "radarr_review_setup":
  case "lidarr_review_setup": {
    const serviceName = name.split('_')[0] as keyof typeof clients;
    const client = clients[serviceName];
    if (!client) throw new Error(`${serviceName} not configured`);
  
    // Gather all configuration data
    const [status, health, qualityProfiles, qualityDefinitions, downloadClients, naming, mediaManagement, rootFolders, tags, indexers] = await Promise.all([
      client.getStatus(),
      client.getHealth(),
      client.getQualityProfiles(),
      client.getQualityDefinitions(),
      client.getDownloadClients(),
      client.getNamingConfig(),
      client.getMediaManagement(),
      client.getRootFoldersDetailed(),
      client.getTags(),
      client.getIndexers(),
    ]);
  
    // For Lidarr, also get metadata profiles
    let metadataProfiles = null;
    if (serviceName === 'lidarr' && clients.lidarr) {
      metadataProfiles = await clients.lidarr.getMetadataProfiles();
    }
  
    const review = {
      service: serviceName,
      version: status.version,
      appName: status.appName,
      platform: {
        os: status.osName,
        isDocker: status.isDocker,
      },
      health: {
        issueCount: health.length,
        issues: health,
      },
      storage: {
        rootFolders: rootFolders.map(f => ({
          path: f.path,
          accessible: f.accessible,
          freeSpace: formatBytes(f.freeSpace),
          freeSpaceBytes: f.freeSpace,
          unmappedFolderCount: f.unmappedFolders?.length || 0,
        })),
      },
      qualityProfiles: qualityProfiles.map(p => ({
        id: p.id,
        name: p.name,
        upgradeAllowed: p.upgradeAllowed,
        cutoff: p.cutoff,
        allowedQualities: p.items
          .filter(i => i.allowed)
          .map(i => i.quality?.name || i.name || (i.items?.map(q => q.quality.name).join(', ')))
          .filter(Boolean),
        customFormatsWithScores: p.formatItems?.filter(f => f.score !== 0).length || 0,
        minFormatScore: p.minFormatScore,
      })),
      qualityDefinitions: qualityDefinitions.map(d => ({
        quality: d.quality.name,
        minSize: d.minSize + ' MB/min',
        maxSize: d.maxSize === 0 ? 'unlimited' : d.maxSize + ' MB/min',
        preferredSize: d.preferredSize + ' MB/min',
      })),
      downloadClients: downloadClients.map(c => ({
        name: c.name,
        type: c.implementationName,
        protocol: c.protocol,
        enabled: c.enable,
        priority: c.priority,
      })),
      indexers: indexers.map(i => ({
        name: i.name,
        protocol: i.protocol,
        enableRss: i.enableRss,
        enableAutomaticSearch: i.enableAutomaticSearch,
        enableInteractiveSearch: i.enableInteractiveSearch,
        priority: i.priority,
      })),
      naming: naming,
      mediaManagement: {
        recycleBin: mediaManagement.recycleBin || 'not set',
        recycleBinCleanupDays: mediaManagement.recycleBinCleanupDays,
        downloadPropersAndRepacks: mediaManagement.downloadPropersAndRepacks,
        deleteEmptyFolders: mediaManagement.deleteEmptyFolders,
        copyUsingHardlinks: mediaManagement.copyUsingHardlinks,
        importExtraFiles: mediaManagement.importExtraFiles,
        extraFileExtensions: mediaManagement.extraFileExtensions,
      },
      tags: tags.map(t => t.label),
      ...(metadataProfiles && { metadataProfiles }),
    };
  
    return {
      content: [{
        type: "text",
        text: JSON.stringify(review, null, 2),
      }],
    };
  }

• src/index.ts:132-198 (helper)

  The addConfigTools() helper function that dynamically creates the sonarr_review_setup tool registration along with other config tools for each service.

  function addConfigTools(serviceName: string, displayName: string) {
    TOOLS.push(
      {
        name: `${serviceName}_get_quality_profiles`,
        description: `Get detailed quality profiles from ${displayName}. Shows allowed qualities, upgrade settings, and custom format scores.`,
        inputSchema: {
          type: "object" as const,
          properties: {},
          required: [],
        },
      },
      {
        name: `${serviceName}_get_health`,
        description: `Get health check warnings and issues from ${displayName}. Shows any problems detected by the application.`,
        inputSchema: {
          type: "object" as const,
          properties: {},
          required: [],
        },
      },
      {
        name: `${serviceName}_get_root_folders`,
        description: `Get root folders and storage info from ${displayName}. Shows paths, free space, and unmapped folders.`,
        inputSchema: {
          type: "object" as const,
          properties: {},
          required: [],
        },
      },
      {
        name: `${serviceName}_get_download_clients`,
        description: `Get download client configurations from ${displayName}. Shows configured clients and their settings.`,
        inputSchema: {
          type: "object" as const,
          properties: {},
          required: [],
        },
      },
      {
        name: `${serviceName}_get_naming`,
        description: `Get file naming configuration from ${displayName}. Shows naming patterns for files and folders.`,
        inputSchema: {
          type: "object" as const,
          properties: {},
          required: [],
        },
      },
      {
        name: `${serviceName}_get_tags`,
        description: `Get all tags defined in ${displayName}. Tags can be used to organize and filter content.`,
        inputSchema: {
          type: "object" as const,
          properties: {},
          required: [],
        },
      },
      {
        name: `${serviceName}_review_setup`,
        description: `Get comprehensive configuration review for ${displayName}. Returns all settings for analysis: quality profiles, download clients, naming, storage, indexers, health warnings, and more. Use this to analyze the setup and suggest improvements.`,
        inputSchema: {
          type: "object" as const,
          properties: {},
          required: [],
        },
      }
    );
  }