MCP *arr Server

Instructions

Implementation Reference

• src/index.ts:883-910 (handler)

  Handler logic for 'radarr_get_download_clients': parses tool name to get service, retrieves RadarrClient instance, calls getDownloadClients(), formats response as summarized JSON with client details.
  case "sonarr_get_download_clients": case "radarr_get_download_clients": case "lidarr_get_download_clients": case "readarr_get_download_clients": { const serviceName = name.split('_')[0] as keyof typeof clients; const client = clients[serviceName]; if (!client) throw new Error(`${serviceName} not configured`); const downloadClients = await client.getDownloadClients(); return { content: [{ type: "text", text: JSON.stringify({ count: downloadClients.length, clients: downloadClients.map(c => ({ id: c.id, name: c.name, implementation: c.implementationName, protocol: c.protocol, enabled: c.enable, priority: c.priority, removeCompletedDownloads: c.removeCompletedDownloads, removeFailedDownloads: c.removeFailedDownloads, tags: c.tags, })), }, null, 2), }], }; }
• src/index.ts:136-142 (registration)

  Tool registration in addConfigTools function, creates 'radarr_get_download_clients' name via template string, defines description and empty input schema. Called when Radarr client is configured (line 176).
  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: [], },
• src/index.ts:136-142 (schema)

  Input schema definition for the tool: empty object (no parameters 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: [], },
• src/arr-client.ts:542-545 (helper)

  ArrClient.getDownloadClients() method: makes authenticated API request to /downloadclient endpoint, returns DownloadClient[] array. Inherited by RadarrClient.
  */ async getDownloadClients(): Promise<DownloadClient[]> { return this.request<DownloadClient[]>('/downloadclient'); }
• src/arr-client.ts:326-342 (schema)

  TypeScript interface defining the structure of DownloadClient objects returned from the *arr API and used in handler response.
  export interface DownloadClient { id: number; name: string; implementation: string; implementationName: string; configContract: string; enable: boolean; protocol: string; priority: number; removeCompletedDownloads: boolean; removeFailedDownloads: boolean; fields: Array<{ name: string; value: unknown; }>; tags: number[]; }