mcp-arr-server 1.5.2 → 1.5.4

package/dist/index.js

@@ -3,25 +3,23 @@
  * MCP Server for *arr Media Management Suite
  *
  * Provides tools for managing Sonarr (TV), Radarr (Movies), Lidarr (Music),
- * Readarr (Books), and Prowlarr (Indexers) through Claude Code.
+ * and Prowlarr (Indexers) through Claude Code.
  *
  * Environment variables:
  * - SONARR_URL, SONARR_API_KEY
  * - RADARR_URL, RADARR_API_KEY
  * - LIDARR_URL, LIDARR_API_KEY
- * - READARR_URL, READARR_API_KEY
  * - PROWLARR_URL, PROWLARR_API_KEY
  */
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
-import { SonarrClient, RadarrClient, LidarrClient, ReadarrClient, ProwlarrClient, } from "./arr-client.js";
+import { SonarrClient, RadarrClient, LidarrClient, ProwlarrClient, } from "./arr-client.js";
 import { trashClient } from "./trash-client.js";
 const services = [
     { name: 'sonarr', displayName: 'Sonarr (TV)', url: process.env.SONARR_URL, apiKey: process.env.SONARR_API_KEY },
     { name: 'radarr', displayName: 'Radarr (Movies)', url: process.env.RADARR_URL, apiKey: process.env.RADARR_API_KEY },
     { name: 'lidarr', displayName: 'Lidarr (Music)', url: process.env.LIDARR_URL, apiKey: process.env.LIDARR_API_KEY },
-    { name: 'readarr', displayName: 'Readarr (Books)', url: process.env.READARR_URL, apiKey: process.env.READARR_API_KEY },
     { name: 'prowlarr', displayName: 'Prowlarr (Indexers)', url: process.env.PROWLARR_URL, apiKey: process.env.PROWLARR_API_KEY },
 ];
 // Check which services are configured
@@ -45,9 +43,6 @@ for (const service of configuredServices) {
         case 'lidarr':
             clients.lidarr = new LidarrClient(config);
             break;
-        case 'readarr':
-            clients.readarr = new ReadarrClient(config);
-            break;
         case 'prowlarr':
             clients.prowlarr = new ProwlarrClient(config);
             break;
@@ -135,8 +130,6 @@ if (clients.radarr)
     addConfigTools('radarr', 'Radarr (Movies)');
 if (clients.lidarr)
     addConfigTools('lidarr', 'Lidarr (Music)');
-if (clients.readarr)
-    addConfigTools('readarr', 'Readarr (Books)');
 // Sonarr tools
 if (clients.sonarr) {
     TOOLS.push({
@@ -263,22 +256,6 @@ if (clients.sonarr) {
             },
             required: ["tvdbId", "title", "qualityProfileId", "rootFolderPath"],
         },
-    }, {
-        name: "sonarr_get_root_folders",
-        description: "Get available root folders for Sonarr. Use this to find valid rootFolderPath values when adding a series.",
-        inputSchema: {
-            type: "object",
-            properties: {},
-            required: [],
-        },
-    }, {
-        name: "sonarr_get_quality_profiles",
-        description: "Get available quality profiles for Sonarr. Use this to find valid qualityProfileId values when adding a series.",
-        inputSchema: {
-            type: "object",
-            properties: {},
-            required: [],
-        },
     });
 }
 // Radarr tools
@@ -377,22 +354,6 @@ if (clients.radarr) {
             },
             required: ["tmdbId", "title", "qualityProfileId", "rootFolderPath"],
         },
-    }, {
-        name: "radarr_get_root_folders",
-        description: "Get available root folders for Radarr. Use this to find valid rootFolderPath values when adding a movie.",
-        inputSchema: {
-            type: "object",
-            properties: {},
-            required: [],
-        },
-    }, {
-        name: "radarr_get_quality_profiles",
-        description: "Get available quality profiles for Radarr. Use this to find valid qualityProfileId values when adding a movie.",
-        inputSchema: {
-            type: "object",
-            properties: {},
-            required: [],
-        },
     });
 }
 // Lidarr tools
@@ -542,154 +503,6 @@ if (clients.lidarr) {
         },
     });
 }
-// Readarr tools
-if (clients.readarr) {
-    TOOLS.push({
-        name: "readarr_get_authors",
-        description: "Get all authors in Readarr library",
-        inputSchema: {
-            type: "object",
-            properties: {},
-            required: [],
-        },
-    }, {
-        name: "readarr_search",
-        description: "Search for authors by name. Returns results with foreignAuthorId needed for readarr_add_author.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                term: {
-                    type: "string",
-                    description: "Search term (author name)",
-                },
-            },
-            required: ["term"],
-        },
-    }, {
-        name: "readarr_get_queue",
-        description: "Get Readarr download queue",
-        inputSchema: {
-            type: "object",
-            properties: {},
-            required: [],
-        },
-    }, {
-        name: "readarr_get_books",
-        description: "Get books for an author in Readarr. Shows which books are available and which are missing.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                authorId: {
-                    type: "number",
-                    description: "Author ID to get books for",
-                },
-            },
-            required: ["authorId"],
-        },
-    }, {
-        name: "readarr_search_book",
-        description: "Trigger a search for a specific book to download",
-        inputSchema: {
-            type: "object",
-            properties: {
-                bookIds: {
-                    type: "array",
-                    items: { type: "number" },
-                    description: "Book ID(s) to search for",
-                },
-            },
-            required: ["bookIds"],
-        },
-    }, {
-        name: "readarr_search_missing",
-        description: "Trigger a search for all missing books for an author",
-        inputSchema: {
-            type: "object",
-            properties: {
-                authorId: {
-                    type: "number",
-                    description: "Author ID to search missing books for",
-                },
-            },
-            required: ["authorId"],
-        },
-    }, {
-        name: "readarr_get_calendar",
-        description: "Get upcoming book releases from Readarr",
-        inputSchema: {
-            type: "object",
-            properties: {
-                days: {
-                    type: "number",
-                    description: "Number of days to look ahead (default: 30)",
-                },
-            },
-            required: [],
-        },
-    }, {
-        name: "readarr_add_author",
-        description: "Add an author to Readarr. Use readarr_search first to find the foreignAuthorId, and readarr_get_root_folders / readarr_get_quality_profiles / readarr_get_metadata_profiles to get valid values. Use readarr_get_tags to get valid tag IDs.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                foreignAuthorId: {
-                    type: "string",
-                    description: "Foreign author ID from readarr_search results",
-                },
-                authorName: {
-                    type: "string",
-                    description: "Author name",
-                },
-                qualityProfileId: {
-                    type: "number",
-                    description: "Quality profile ID from readarr_get_quality_profiles",
-                },
-                metadataProfileId: {
-                    type: "number",
-                    description: "Metadata profile ID from readarr_get_metadata_profiles",
-                },
-                rootFolderPath: {
-                    type: "string",
-                    description: "Root folder path from readarr_get_root_folders",
-                },
-                monitored: {
-                    type: "boolean",
-                    description: "Whether to monitor the author (default: true)",
-                },
-                tags: {
-                    type: "array",
-                    items: { type: "number" },
-                    description: "Array of tag IDs from readarr_get_tags (optional)",
-                },
-            },
-            required: ["foreignAuthorId", "authorName", "qualityProfileId", "metadataProfileId", "rootFolderPath"],
-        },
-    }, {
-        name: "readarr_get_root_folders",
-        description: "Get available root folders for Readarr. Use this to find valid rootFolderPath values when adding an author.",
-        inputSchema: {
-            type: "object",
-            properties: {},
-            required: [],
-        },
-    }, {
-        name: "readarr_get_quality_profiles",
-        description: "Get available quality profiles for Readarr. Use this to find valid qualityProfileId values when adding an author.",
-        inputSchema: {
-            type: "object",
-            properties: {},
-            required: [],
-        },
-    }, {
-        name: "readarr_get_metadata_profiles",
-        description: "Get available metadata profiles for Readarr. Use this to find valid metadataProfileId values when adding an author.",
-        inputSchema: {
-            type: "object",
-            properties: {},
-            required: [],
-        },
-    });
-}
 // Prowlarr tools
 if (clients.prowlarr) {
     TOOLS.push({
@@ -931,8 +744,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             // Quality Profiles
             case "sonarr_get_quality_profiles":
             case "radarr_get_quality_profiles":
-            case "lidarr_get_quality_profiles":
-            case "readarr_get_quality_profiles": {
+            case "lidarr_get_quality_profiles": {
                 const serviceName = name.split('_')[0];
                 const client = clients[serviceName];
                 if (!client)
@@ -966,8 +778,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             // Health checks
             case "sonarr_get_health":
             case "radarr_get_health":
-            case "lidarr_get_health":
-            case "readarr_get_health": {
+            case "lidarr_get_health": {
                 const serviceName = name.split('_')[0];
                 const client = clients[serviceName];
                 if (!client)
@@ -992,8 +803,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             // Root folders
             case "sonarr_get_root_folders":
             case "radarr_get_root_folders":
-            case "lidarr_get_root_folders":
-            case "readarr_get_root_folders": {
+            case "lidarr_get_root_folders": {
                 const serviceName = name.split('_')[0];
                 const client = clients[serviceName];
                 if (!client)
@@ -1019,8 +829,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             // Download clients
             case "sonarr_get_download_clients":
             case "radarr_get_download_clients":
-            case "lidarr_get_download_clients":
-            case "readarr_get_download_clients": {
+            case "lidarr_get_download_clients": {
                 const serviceName = name.split('_')[0];
                 const client = clients[serviceName];
                 if (!client)
@@ -1049,8 +858,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             // Naming config
             case "sonarr_get_naming":
             case "radarr_get_naming":
-            case "lidarr_get_naming":
-            case "readarr_get_naming": {
+            case "lidarr_get_naming": {
                 const serviceName = name.split('_')[0];
                 const client = clients[serviceName];
                 if (!client)
@@ -1066,8 +874,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             // Tags
             case "sonarr_get_tags":
             case "radarr_get_tags":
-            case "lidarr_get_tags":
-            case "readarr_get_tags": {
+            case "lidarr_get_tags": {
                 const serviceName = name.split('_')[0];
                 const client = clients[serviceName];
                 if (!client)
@@ -1086,8 +893,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             // Comprehensive setup review
             case "sonarr_review_setup":
             case "radarr_review_setup":
-            case "lidarr_review_setup":
-            case "readarr_review_setup": {
+            case "lidarr_review_setup": {
                 const serviceName = name.split('_')[0];
                 const client = clients[serviceName];
                 if (!client)
@@ -1105,14 +911,11 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     client.getTags(),
                     client.getIndexers(),
                 ]);
-                // For Lidarr/Readarr, also get metadata profiles
+                // For Lidarr, also get metadata profiles
                 let metadataProfiles = null;
                 if (serviceName === 'lidarr' && clients.lidarr) {
                     metadataProfiles = await clients.lidarr.getMetadataProfiles();
                 }
-                else if (serviceName === 'readarr' && clients.readarr) {
-                    metadataProfiles = await clients.readarr.getMetadataProfiles();
-                }
                 const review = {
                     service: serviceName,
                     version: status.version,
@@ -1338,28 +1141,6 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                         }],
                 };
             }
-            case "sonarr_get_root_folders": {
-                if (!clients.sonarr)
-                    throw new Error("Sonarr not configured");
-                const folders = await clients.sonarr.getRootFolders();
-                return {
-                    content: [{
-                            type: "text",
-                            text: JSON.stringify(folders, null, 2),
-                        }],
-                };
-            }
-            case "sonarr_get_quality_profiles": {
-                if (!clients.sonarr)
-                    throw new Error("Sonarr not configured");
-                const profiles = await clients.sonarr.getQualityProfiles();
-                return {
-                    content: [{
-                            type: "text",
-                            text: JSON.stringify(profiles.map(p => ({ id: p.id, name: p.name })), null, 2),
-                        }],
-                };
-            }
             // Radarr handlers
             case "radarr_get_movies": {
                 if (!clients.radarr)
@@ -1472,28 +1253,6 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                         }],
                 };
             }
-            case "radarr_get_root_folders": {
-                if (!clients.radarr)
-                    throw new Error("Radarr not configured");
-                const folders = await clients.radarr.getRootFolders();
-                return {
-                    content: [{
-                            type: "text",
-                            text: JSON.stringify(folders, null, 2),
-                        }],
-                };
-            }
-            case "radarr_get_quality_profiles": {
-                if (!clients.radarr)
-                    throw new Error("Radarr not configured");
-                const profiles = await clients.radarr.getQualityProfiles();
-                return {
-                    content: [{
-                            type: "text",
-                            text: JSON.stringify(profiles.map(p => ({ id: p.id, name: p.name })), null, 2),
-                        }],
-                };
-            }
             // Lidarr handlers
             case "lidarr_get_artists": {
                 if (!clients.lidarr)
@@ -1520,7 +1279,10 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             case "lidarr_search": {
                 if (!clients.lidarr)
                     throw new Error("Lidarr not configured");
-                const term = args.term;
+                const a = args;
+                const term = a.term ?? a.query ?? a.artist ?? a.name;
+                if (!term)
+                    throw new Error("term required (artist name)");
                 const results = await clients.lidarr.searchArtists(term);
                 return {
                     content: [{
@@ -1528,9 +1290,10 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                             text: JSON.stringify({
                                 count: results.length,
                                 results: results.slice(0, 10).map(r => ({
-                                    title: r.title,
+                                    artistName: r.artistName ?? r.title,
+                                    disambiguation: r.disambiguation,
                                     foreignArtistId: r.foreignArtistId,
-                                    overview: r.overview?.substring(0, 200) + (r.overview && r.overview.length > 200 ? '...' : ''),
+                                    overview: r.overview ? (r.overview.substring(0, 200) + (r.overview.length > 200 ? '...' : '')) : undefined,
                                 })),
                             }, null, 2),
                         }],
@@ -1690,199 +1453,6 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                         }],
                 };
             }
-            // Readarr handlers
-            case "readarr_get_authors": {
-                if (!clients.readarr)
-                    throw new Error("Readarr not configured");
-                const authors = await clients.readarr.getAuthors();
-                return {
-                    content: [{
-                            type: "text",
-                            text: JSON.stringify({
-                                count: authors.length,
-                                authors: authors.map(a => ({
-                                    id: a.id,
-                                    authorName: a.authorName,
-                                    status: a.status,
-                                    books: a.statistics?.bookFileCount + '/' + a.statistics?.totalBookCount,
-                                    sizeOnDisk: formatBytes(a.statistics?.sizeOnDisk || 0),
-                                    monitored: a.monitored,
-                                })),
-                            }, null, 2),
-                        }],
-                };
-            }
-            case "readarr_search": {
-                if (!clients.readarr)
-                    throw new Error("Readarr not configured");
-                const term = args.term;
-                const results = await clients.readarr.searchAuthors(term);
-                return {
-                    content: [{
-                            type: "text",
-                            text: JSON.stringify({
-                                count: results.length,
-                                results: results.slice(0, 10).map(r => ({
-                                    title: r.title,
-                                    foreignAuthorId: r.foreignAuthorId,
-                                    overview: r.overview?.substring(0, 200) + (r.overview && r.overview.length > 200 ? '...' : ''),
-                                })),
-                            }, null, 2),
-                        }],
-                };
-            }
-            case "readarr_get_queue": {
-                if (!clients.readarr)
-                    throw new Error("Readarr not configured");
-                const queue = await clients.readarr.getQueue();
-                return {
-                    content: [{
-                            type: "text",
-                            text: JSON.stringify({
-                                totalRecords: queue.totalRecords,
-                                items: queue.records.map(q => ({
-                                    title: q.title,
-                                    status: q.status,
-                                    progress: ((1 - q.sizeleft / q.size) * 100).toFixed(1) + '%',
-                                    timeLeft: q.timeleft,
-                                    downloadClient: q.downloadClient,
-                                })),
-                            }, null, 2),
-                        }],
-                };
-            }
-            case "readarr_get_books": {
-                if (!clients.readarr)
-                    throw new Error("Readarr not configured");
-                const authorId = args.authorId;
-                const books = await clients.readarr.getBooks(authorId);
-                return {
-                    content: [{
-                            type: "text",
-                            text: JSON.stringify({
-                                count: books.length,
-                                books: books.map(b => ({
-                                    id: b.id,
-                                    title: b.title,
-                                    releaseDate: b.releaseDate,
-                                    pageCount: b.pageCount,
-                                    monitored: b.monitored,
-                                    hasFile: b.statistics ? b.statistics.bookFileCount > 0 : false,
-                                    sizeOnDisk: formatBytes(b.statistics?.sizeOnDisk || 0),
-                                    grabbed: b.grabbed,
-                                })),
-                            }, null, 2),
-                        }],
-                };
-            }
-            case "readarr_search_book": {
-                if (!clients.readarr)
-                    throw new Error("Readarr not configured");
-                const bookIds = args.bookIds;
-                const result = await clients.readarr.searchBook(bookIds);
-                return {
-                    content: [{
-                            type: "text",
-                            text: JSON.stringify({
-                                success: true,
-                                message: `Search triggered for ${bookIds.length} book(s)`,
-                                commandId: result.id,
-                            }, null, 2),
-                        }],
-                };
-            }
-            case "readarr_search_missing": {
-                if (!clients.readarr)
-                    throw new Error("Readarr not configured");
-                const authorId = args.authorId;
-                const result = await clients.readarr.searchMissingBooks(authorId);
-                return {
-                    content: [{
-                            type: "text",
-                            text: JSON.stringify({
-                                success: true,
-                                message: `Search triggered for missing books`,
-                                commandId: result.id,
-                            }, null, 2),
-                        }],
-                };
-            }
-            case "readarr_get_calendar": {
-                if (!clients.readarr)
-                    throw new Error("Readarr not configured");
-                const days = args?.days || 30;
-                const start = new Date().toISOString().split('T')[0];
-                const end = new Date(Date.now() + days * 24 * 60 * 60 * 1000).toISOString().split('T')[0];
-                const calendar = await clients.readarr.getCalendar(start, end);
-                return {
-                    content: [{
-                            type: "text",
-                            text: JSON.stringify({
-                                count: calendar.length,
-                                books: calendar.map(b => ({
-                                    id: b.id,
-                                    title: b.title,
-                                    authorId: b.authorId,
-                                    releaseDate: b.releaseDate,
-                                    monitored: b.monitored,
-                                })),
-                            }, null, 2),
-                        }],
-                };
-            }
-            case "readarr_add_author": {
-                if (!clients.readarr)
-                    throw new Error("Readarr not configured");
-                const { foreignAuthorId, authorName, qualityProfileId, metadataProfileId, rootFolderPath, monitored, tags } = args;
-                const added = await clients.readarr.addAuthor({
-                    foreignAuthorId, authorName, qualityProfileId, metadataProfileId, rootFolderPath, monitored, tags: tags ?? [],
-                });
-                return {
-                    content: [{
-                            type: "text",
-                            text: JSON.stringify({
-                                success: true,
-                                message: `Added "${added.authorName}" to Readarr`,
-                                id: added.id,
-                                path: added.path,
-                                monitored: added.monitored,
-                            }, null, 2),
-                        }],
-                };
-            }
-            case "readarr_get_root_folders": {
-                if (!clients.readarr)
-                    throw new Error("Readarr not configured");
-                const folders = await clients.readarr.getRootFolders();
-                return {
-                    content: [{
-                            type: "text",
-                            text: JSON.stringify(folders, null, 2),
-                        }],
-                };
-            }
-            case "readarr_get_quality_profiles": {
-                if (!clients.readarr)
-                    throw new Error("Readarr not configured");
-                const profiles = await clients.readarr.getQualityProfiles();
-                return {
-                    content: [{
-                            type: "text",
-                            text: JSON.stringify(profiles.map(p => ({ id: p.id, name: p.name })), null, 2),
-                        }],
-                };
-            }
-            case "readarr_get_metadata_profiles": {
-                if (!clients.readarr)
-                    throw new Error("Readarr not configured");
-                const profiles = await clients.readarr.getMetadataProfiles();
-                return {
-                    content: [{
-                            type: "text",
-                            text: JSON.stringify(profiles.map(p => ({ id: p.id, name: p.name })), null, 2),
-                        }],
-                };
-            }
             // Prowlarr handlers
             case "prowlarr_get_indexers": {
                 if (!clients.prowlarr)
@@ -1996,15 +1566,6 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                         results.lidarr = { error: e instanceof Error ? e.message : String(e) };
                     }
                 }
-                if (clients.readarr) {
-                    try {
-                        const readarrResults = await clients.readarr.searchAuthors(term);
-                        results.readarr = { count: readarrResults.length, results: readarrResults.slice(0, 5) };
-                    }
-                    catch (e) {
-                        results.readarr = { error: e instanceof Error ? e.message : String(e) };
-                    }
-                }
                 return {
                     content: [{ type: "text", text: JSON.stringify(results, null, 2) }],
                 };