MCP *arr Server

Instructions

Implementation Reference

• src/index.ts:692-712 (registration)

  Registration of the 'trash_compare_profile' tool in the TOOLS array, including the name, description, and input schema for MCP tool discovery.

  name: "trash_compare_profile",
  description: "Compare your quality profile against TRaSH Guides recommendations. Shows missing custom formats, scoring differences, and quality settings. Requires the corresponding *arr service to be configured.",
  inputSchema: {
    type: "object" as const,
    properties: {
      service: {
        type: "string",
        enum: ["radarr", "sonarr"],
        description: "Which service",
      },
      profileId: {
        type: "number",
        description: "Your quality profile ID to compare",
      },
      trashProfile: {
        type: "string",
        description: "TRaSH profile name to compare against",
      },
    },
    required: ["service", "profileId", "trashProfile"],
  },

• src/index.ts:692-712 (schema)

  Input schema definition for the 'trash_compare_profile' tool, specifying parameters: service (radarr/sonarr), profileId (number), trashProfile (string).

  name: "trash_compare_profile",
  description: "Compare your quality profile against TRaSH Guides recommendations. Shows missing custom formats, scoring differences, and quality settings. Requires the corresponding *arr service to be configured.",
  inputSchema: {
    type: "object" as const,
    properties: {
      service: {
        type: "string",
        enum: ["radarr", "sonarr"],
        description: "Which service",
      },
      profileId: {
        type: "number",
        description: "Your quality profile ID to compare",
      },
      trashProfile: {
        type: "string",
        description: "TRaSH profile name to compare against",
      },
    },
    required: ["service", "profileId", "trashProfile"],
  },

• src/index.ts:1838-1954 (handler)

  Core handler implementation for 'trash_compare_profile'. Fetches user's *arr quality profile and TRaSH profile, compares allowed qualities and custom formats (matching, missing, extra), and returns structured comparison with recommendations.

  case "trash_compare_profile": {
    const { service, profileId, trashProfile } = args as {
      service: TrashService;
      profileId: number;
      trashProfile: string;
    };
  
    // Get client
    const client = service === 'radarr' ? clients.radarr : clients.sonarr;
    if (!client) {
      return {
        content: [{
          type: "text",
          text: JSON.stringify({ error: `${service} not configured. Cannot compare profiles.` }, null, 2),
        }],
        isError: true,
      };
    }
  
    // Fetch both profiles
    const [userProfiles, trashProfileData] = await Promise.all([
      client.getQualityProfiles(),
      trashClient.getProfile(service, trashProfile),
    ]);
  
    const userProfile = userProfiles.find(p => p.id === profileId);
    if (!userProfile) {
      return {
        content: [{
          type: "text",
          text: JSON.stringify({
            error: `Profile ID ${profileId} not found`,
            availableProfiles: userProfiles.map(p => ({ id: p.id, name: p.name })),
          }, null, 2),
        }],
        isError: true,
      };
    }
  
    if (!trashProfileData) {
      return {
        content: [{
          type: "text",
          text: JSON.stringify({
            error: `TRaSH profile '${trashProfile}' not found`,
            hint: "Use trash_list_profiles to see available profiles",
          }, null, 2),
        }],
        isError: true,
      };
    }
  
    // Compare qualities
    const userQualities = new Set<string>(
      userProfile.items
        .filter(i => i.allowed)
        .map(i => i.quality?.name || i.name)
        .filter((n): n is string => n !== undefined)
    );
    const trashQualities = new Set<string>(
      trashProfileData.items
        .filter(i => i.allowed)
        .map(i => i.name)
    );
  
    const qualityComparison = {
      matching: [...userQualities].filter(q => trashQualities.has(q)),
      missingFromYours: [...trashQualities].filter(q => !userQualities.has(q)),
      extraInYours: [...userQualities].filter(q => !trashQualities.has(q)),
    };
  
    // Compare custom formats
    const userCFNames = new Set(
      (userProfile.formatItems || [])
        .filter(f => f.score !== 0)
        .map(f => f.name)
    );
    const trashCFNames = new Set(Object.keys(trashProfileData.formatItems || {}));
  
    const cfComparison = {
      matching: [...userCFNames].filter(cf => trashCFNames.has(cf)),
      missingFromYours: [...trashCFNames].filter(cf => !userCFNames.has(cf)),
      extraInYours: [...userCFNames].filter(cf => !trashCFNames.has(cf)),
    };
  
    return {
      content: [{
        type: "text",
        text: JSON.stringify({
          yourProfile: {
            name: userProfile.name,
            id: userProfile.id,
            upgradeAllowed: userProfile.upgradeAllowed,
            cutoff: userProfile.cutoff,
          },
          trashProfile: {
            name: trashProfileData.name,
            upgradeAllowed: trashProfileData.upgradeAllowed,
            cutoff: trashProfileData.cutoff,
          },
          qualityComparison,
          customFormatComparison: cfComparison,
          recommendations: [
            ...(qualityComparison.missingFromYours.length > 0
              ? [`Enable these qualities: ${qualityComparison.missingFromYours.join(', ')}`]
              : []),
            ...(cfComparison.missingFromYours.length > 0
              ? [`Add these custom formats: ${cfComparison.missingFromYours.slice(0, 5).join(', ')}${cfComparison.missingFromYours.length > 5 ? ` and ${cfComparison.missingFromYours.length - 5} more` : ''}`]
              : []),
            ...(userProfile.upgradeAllowed !== trashProfileData.upgradeAllowed
              ? [`Set upgradeAllowed to ${trashProfileData.upgradeAllowed}`]
              : []),
          ],
        }, null, 2),
      }],
    };
  }