MCP *arr Server

Instructions

Implementation Reference

• src/index.ts:615-631 (registration)

  Tool registration for trash_get_profile including name, description, and input schema.

  name: "trash_get_profile",
  description: "Get a specific TRaSH Guides quality profile with all custom format scores, quality settings, and implementation details",
  inputSchema: {
    type: "object" as const,
    properties: {
      service: {
        type: "string",
        enum: ["radarr", "sonarr"],
        description: "Which service",
      },
      profile: {
        type: "string",
        description: "Profile name (e.g., 'remux-web-1080p', 'uhd-bluray-web', 'hd-bluray-web')",
      },
    },
    required: ["service", "profile"],
  },

• src/index.ts:1710-1749 (handler)

  Main handler for trash_get_profile: extracts arguments, calls trashClient.getProfile, handles errors, formats and returns profile data as JSON.

  case "trash_get_profile": {
    const { service, profile: profileName } = args as { service: TrashService; profile: string };
    const profile = await trashClient.getProfile(service, profileName);
    if (!profile) {
      return {
        content: [{
          type: "text",
          text: JSON.stringify({
            error: `Profile '${profileName}' not found for ${service}`,
            hint: "Use trash_list_profiles to see available profiles",
          }, null, 2),
        }],
        isError: true,
      };
    }
    return {
      content: [{
        type: "text",
        text: JSON.stringify({
          name: profile.name,
          description: profile.trash_description?.replace(/<br>/g, '\n'),
          trash_id: profile.trash_id,
          upgradeAllowed: profile.upgradeAllowed,
          cutoff: profile.cutoff,
          minFormatScore: profile.minFormatScore,
          cutoffFormatScore: profile.cutoffFormatScore,
          language: profile.language,
          qualities: profile.items.map(i => ({
            name: i.name,
            allowed: i.allowed,
            items: i.items,
          })),
          customFormats: Object.entries(profile.formatItems || {}).map(([name, trashId]) => ({
            name,
            trash_id: trashId,
          })),
        }, null, 2),
      }],
    };
  }

• src/trash-client.ts:259-273 (helper)

  Core helper function getProfile in TrashClient: checks cache, fetches JSON from TRaSH GitHub repo if needed, caches result.

  async getProfile(service: TrashService, profileName: string): Promise<TrashQualityProfile | null> {
    const key = `${service}/${profileName}`;
    const cached = cache.getProfile(key);
    if (cached) return cached;
  
    try {
      const profile = await fetchJSON<TrashQualityProfile>(
        `${TRASH_BASE_URL}/${service}/quality-profiles/${profileName}.json`
      );
      cache.setProfile(key, profile);
      return profile;
    } catch {
      return null;
    }
  }

• src/index.ts:31-32 (helper)

  Import of trashClient singleton and TrashService type used by the tool.

  import { trashClient, TrashService } from "./trash-client.js";

• src/trash-client.ts:31-48 (schema)

  TrashQualityProfile interface defining the structure of profile data returned by the tool.

  export interface TrashQualityProfile {
    trash_id: string;
    name: string;
    trash_description?: string;
    group?: number;
    upgradeAllowed: boolean;
    cutoff: string;
    minFormatScore: number;
    cutoffFormatScore: number;
    minUpgradeFormatScore: number;
    language: string;
    items: Array<{
      name: string;
      allowed: boolean;
      items?: string[];
    }>;
    formatItems: Record<string, string>;
  }