MCP *arr Server

Instructions

Implementation Reference

• src/arr-client.ts:662-670 (handler)

  Core implementation of sonarr_search_episode: Posts 'EpisodeSearch' command to Sonarr API with episode IDs.

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

• src/index.ts:262-275 (registration)

  Tool registration in TOOLS array, including name, description, and input schema definition.

    name: "sonarr_search_episode",
    description: "Trigger a search for specific episode(s)",
    inputSchema: {
      type: "object" as const,
      properties: {
        episodeIds: {
          type: "array",
          items: { type: "number" },
          description: "Episode ID(s) to search for",
        },
      },
      required: ["episodeIds"],
    },
  }

• src/index.ts:1171-1185 (handler)

  MCP server dispatch handler that validates Sonarr config, extracts arguments, calls SonarrClient.searchEpisode, and formats response.

  case "sonarr_search_episode": {
    if (!clients.sonarr) throw new Error("Sonarr not configured");
    const episodeIds = (args as { episodeIds: number[] }).episodeIds;
    const result = await clients.sonarr.searchEpisode(episodeIds);
    return {
      content: [{
        type: "text",
        text: JSON.stringify({
          success: true,
          message: `Search triggered for ${episodeIds.length} episode(s)`,
          commandId: result.id,
        }, null, 2),
      }],
    };
  }