MCP *arr Server

Instructions

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; }; }