lidarr_get_artists
Retrieve all music artists stored in your Lidarr media library to manage your music collection and monitor artist information.
Instructions
Get all artists in Lidarr library
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/index.ts:348-355 (registration)Registration of the 'lidarr_get_artists' tool in the TOOLS array, including name, description, and empty input schema.{ name: "lidarr_get_artists", description: "Get all artists in Lidarr library", inputSchema: { type: "object" as const, properties: {}, required: [], },
- src/index.ts:1280-1300 (handler)MCP tool call handler: checks configuration, calls LidarrClient.getArtists(), formats and returns JSON response with artist summary.case "lidarr_get_artists": { if (!clients.lidarr) throw new Error("Lidarr not configured"); const artists = await clients.lidarr.getArtists(); return { content: [{ type: "text", text: JSON.stringify({ count: artists.length, artists: artists.map(a => ({ id: a.id, artistName: a.artistName, status: a.status, albums: a.statistics?.albumCount, tracks: a.statistics?.trackFileCount + '/' + a.statistics?.totalTrackCount, sizeOnDisk: formatBytes(a.statistics?.sizeOnDisk || 0), monitored: a.monitored, })), }, null, 2), }], }; }
- src/arr-client.ts:738-740 (handler)LidarrClient.getArtists(): Makes authenticated GET request to Lidarr /api/v1/artist endpoint to fetch all artists.async getArtists(): Promise<Artist[]> { return this['request']<Artist[]>('/artist'); }
- src/arr-client.ts:219-248 (schema)TypeScript interface defining the Artist object structure used in the tool's response.export interface Artist { id: number; artistName: string; sortName: string; status: string; overview: string; artistType: string; disambiguation: string; links: Array<{ url: string; name: string }>; images: Array<{ coverType: string; url: string }>; path: string; qualityProfileId: number; metadataProfileId: number; monitored: boolean; monitorNewItems: string; genres: string[]; cleanName: string; foreignArtistId: string; tags: number[]; added: string; ratings: { votes: number; value: number }; statistics: { albumCount: number; trackFileCount: number; trackCount: number; totalTrackCount: number; sizeOnDisk: number; percentOfTracks: number; }; }