lidarr_search_missing
Search for missing albums by a specific artist in Lidarr to complete your music library collection.
Instructions
Trigger a search for all missing albums for an artist
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| artistId | Yes | Artist ID to search missing albums for |
Implementation Reference
- src/arr-client.ts:790-798 (handler)Core handler implementation in LidarrClient: Posts to Lidarr API /command endpoint with 'ArtistSearch' command to trigger search for missing albums of the specified artist.async searchMissingAlbums(artistId: number): Promise<{ id: number }> { return this['request']<{ id: number }>('/command', { method: 'POST', body: JSON.stringify({ name: 'ArtistSearch', artistId, }), }); }
- src/index.ts:1382-1396 (handler)MCP tool dispatch handler: Validates Lidarr client, extracts artistId from arguments, calls LidarrClient.searchMissingAlbums, and formats success response with command ID.case "lidarr_search_missing": { if (!clients.lidarr) throw new Error("Lidarr not configured"); const artistId = (args as { artistId: number }).artistId; const result = await clients.lidarr.searchMissingAlbums(artistId); return { content: [{ type: "text", text: JSON.stringify({ success: true, message: `Search triggered for missing albums`, commandId: result.id, }, null, 2), }], }; }
- src/index.ts:409-421 (schema)Tool schema definition: Specifies name, description, and input schema requiring 'artistId' (number).name: "lidarr_search_missing", description: "Trigger a search for all missing albums for an artist", inputSchema: { type: "object" as const, properties: { artistId: { type: "number", description: "Artist ID to search missing albums for", }, }, required: ["artistId"], }, },
- src/index.ts:409-421 (registration)Tool registration: Adds the tool to the TOOLS array if Lidarr client is configured (see line 347). Note: schema is co-located.name: "lidarr_search_missing", description: "Trigger a search for all missing albums for an artist", inputSchema: { type: "object" as const, properties: { artistId: { type: "number", description: "Artist ID to search missing albums for", }, }, required: ["artistId"], }, },