MCP *arr Server

Instructions

Implementation Reference

• src/index.ts:174-179 (registration)

  Registration of configuration tools for Lidarr (among others) by calling addConfigTools if Lidarr client is configured, adding 'lidarr_get_quality_profiles' to the TOOLS array.
  // Add config tools for each configured service (except Prowlarr which has different config) if (clients.sonarr) addConfigTools('sonarr', 'Sonarr (TV)'); if (clients.radarr) addConfigTools('radarr', 'Radarr (Movies)'); if (clients.lidarr) addConfigTools('lidarr', 'Lidarr (Music)'); if (clients.readarr) addConfigTools('readarr', 'Readarr (Books)');
• src/index.ts:108-116 (schema)

  Tool schema definition for *_get_quality_profiles (used for lidarr_get_quality_profiles) within addConfigTools function: name, description, empty input schema.
  { 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: [], }, },
• src/index.ts:795-827 (handler)

  Main handler logic for lidarr_get_quality_profiles: parses service name, retrieves Lidarr client, calls getQualityProfiles(), formats output with count, profile summaries, allowed qualities, and custom format scores.
  case "sonarr_get_quality_profiles": case "radarr_get_quality_profiles": case "lidarr_get_quality_profiles": case "readarr_get_quality_profiles": { const serviceName = name.split('_')[0] as keyof typeof clients; const client = clients[serviceName]; if (!client) throw new Error(`${serviceName} not configured`); const profiles = await client.getQualityProfiles(); return { content: [{ type: "text", text: JSON.stringify({ count: profiles.length, profiles: profiles.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), customFormats: p.formatItems?.filter(f => f.score !== 0).map(f => ({ name: f.name, score: f.score, })) || [], minFormatScore: p.minFormatScore, cutoffFormatScore: p.cutoffFormatScore, })), }, null, 2), }], }; }
• src/arr-client.ts:528-531 (helper)

  Core helper method getQualityProfiles() in ArrClient (inherited by LidarrClient) that makes API request to /qualityprofile endpoint.
  */ async getQualityProfiles(): Promise<QualityProfile[]> { return this.request<QualityProfile[]>('/qualityprofile'); }
• src/arr-client.ts:290-309 (schema)

  TypeScript interface defining QualityProfile structure used by getQualityProfiles() response.
  export interface QualityProfile { id: number; name: string; upgradeAllowed: boolean; cutoff: number; items: Array<{ id?: number; name?: string; quality?: { id: number; name: string; source: string; resolution: number }; items?: Array<{ quality: { id: number; name: string } }>; allowed: boolean; }>; minFormatScore: number; cutoffFormatScore: number; formatItems: Array<{ format: number; name: string; score: number; }>; }