lidarr_get_artists
Retrieve all music artists from your Lidarr library to manage and update your collection.
Instructions
Get all artists in Lidarr library
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/index.ts:524-532 (registration)Tool registration: defines the lidarr_get_artists tool with no input parameters, registered when 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:1766-1786 (handler)Handler for lidarr_get_artists: validates Lidarr is configured, calls client.getArtists(), returns count and mapped artist data (id, name, status, album count, track stats, size, monitored).
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:707-709 (helper)LidarrClient.getArtists() helper method that makes a GET request to /api/v1/artist to fetch all artists from Lidarr.
async getArtists(): Promise<Artist[]> { return this['request']<Artist[]>('/artist'); } - src/arr-client.ts:189-218 (schema)The Artist interface (schema) that defines the shape of artist data returned by lidarr_get_artists.
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; }; }