MCP *arr Server

Instructions

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"],
    },
  },