MCP *arr Server

Instructions

Implementation Reference

• src/index.ts:1366-1380 (handler)

  Main handler for the lidarr_search_album tool. Checks Lidarr client configuration, parses albumId from input arguments, calls LidarrClient.searchAlbum, and returns a success response containing the command ID.

  case "lidarr_search_album": {
    if (!clients.lidarr) throw new Error("Lidarr not configured");
    const albumId = (args as { albumId: number }).albumId;
    const result = await clients.lidarr.searchAlbum(albumId);
    return {
      content: [{
        type: "text",
        text: JSON.stringify({
          success: true,
          message: `Search triggered for album`,
          commandId: result.id,
        }, null, 2),
      }],
    };
  }

• src/index.ts:395-407 (registration)

  Tool registration in the TOOLS array, including name, description, and input schema definition for lidarr_search_album. Conditionally added if Lidarr client is configured.

    name: "lidarr_search_album",
    description: "Trigger a search for a specific album to download",
    inputSchema: {
      type: "object" as const,
      properties: {
        albumId: {
          type: "number",
          description: "Album ID to search for",
        },
      },
      required: ["albumId"],
    },
  },

• src/index.ts:395-407 (schema)

  Input schema definition for the lidarr_search_album tool, specifying albumId as a required number parameter.

    name: "lidarr_search_album",
    description: "Trigger a search for a specific album to download",
    inputSchema: {
      type: "object" as const,
      properties: {
        albumId: {
          type: "number",
          description: "Album ID to search for",
        },
      },
      required: ["albumId"],
    },
  },

• src/arr-client.ts:803-811 (helper)

  LidarrClient helper method searchAlbum that performs the actual API call to Lidarr's /command endpoint with 'AlbumSearch' payload containing the album ID, returning the command ID.

  async searchAlbum(albumId: number): Promise<{ id: number }> {
    return this['request']<{ id: number }>('/command', {
      method: 'POST',
      body: JSON.stringify({
        name: 'AlbumSearch',
        albumIds: [albumId],
      }),
    });
  }