lidarr_get_artists
Retrieve all music artists stored in your Lidarr library to manage your music collection effectively.
Instructions
Get all artists in Lidarr library
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/index.ts:1280-1300 (handler)Main handler for 'lidarr_get_artists' tool. Checks if Lidarr client is configured, fetches artists using LidarrClient.getArtists(), summarizes each artist (ID, name, status, album/track counts, size, monitored status), and returns formatted JSON response.
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/index.ts:349-356 (registration)Tool registration in TOOLS array. Defines name, description, and empty input schema (no parameters required). Conditionally added if Lidarr client is configured.
name: "lidarr_get_artists", description: "Get all artists in Lidarr library", inputSchema: { type: "object" as const, properties: {}, required: [], }, }, - src/index.ts:352-355 (schema)Input schema definition for the tool: empty object (no input parameters needed).
type: "object" as const, properties: {}, required: [], }, - src/arr-client.ts:738-740 (helper)LidarrClient.getArtists() method: Makes API request to Lidarr's /artist endpoint to fetch all artists, typed as Artist[]. Called by the main handler.
async getArtists(): Promise<Artist[]> { return this['request']<Artist[]>('/artist'); } - src/arr-client.ts:219-248 (helper)TypeScript interface defining the structure of an Artist object returned from Lidarr API.
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; }; }