MCP *arr Server

Instructions

Implementation Reference

• src/arr-client.ts:638-646 (handler)

  Core handler in SonarrClient that triggers a POST to /command with 'SeriesSearch' for the given seriesId, searching for all missing episodes.

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

• src/index.ts:248-259 (registration)

  Tool registration in TOOLS array, including name, description, and inputSchema for sonarr_search_missing.

  name: "sonarr_search_missing",
  description: "Trigger a search for all missing episodes in a series",
  inputSchema: {
    type: "object" as const,
    properties: {
      seriesId: {
        type: "number",
        description: "Series ID to search for missing episodes",
      },
    },
    required: ["seriesId"],
  },

• src/index.ts:1155-1169 (handler)

  MCP server handler that validates Sonarr client availability, extracts seriesId from args, calls SonarrClient.searchMissing, and formats success response with commandId.

  case "sonarr_search_missing": {
    if (!clients.sonarr) throw new Error("Sonarr not configured");
    const seriesId = (args as { seriesId: number }).seriesId;
    const result = await clients.sonarr.searchMissing(seriesId);
    return {
      content: [{
        type: "text",
        text: JSON.stringify({
          success: true,
          message: `Search triggered for missing episodes`,
          commandId: result.id,
        }, null, 2),
      }],
    };
  }