@cyanheads/seerr-mcp-server 0.1.0

package/dist/mcp-server/tools/definitions/request-status.tool.js

@@ -0,0 +1,111 @@
+/**
+ * @fileoverview seerr_request_status — track one request through its lifecycle.
+ * Wraps `GET /request/{id}`. Returns decoded request + media status, requester
+ * (PII-redacted), a routing summary (names/IDs only — no filesystem paths), and a
+ * status-tuned recovery hint. A missing request id surfaces as request_not_found
+ * (Seerr's raw HTTP 404 is classified in the service layer). `profileName` is null
+ * at this endpoint, so routing.profileName is optional; `title` is not on the
+ * request object, so it is left unpopulated.
+ * @module mcp-server/tools/definitions/request-status.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { projectRequestDetail } from '../../../services/seerr/normalizers.js';
+import { getSeerrService } from '../../../services/seerr/seerr-service.js';
+import { StatusRef, statusText } from '../../../services/seerr/status.js';
+export const requestStatusTool = tool('seerr_request_status', {
+    title: 'seerr-mcp-server: request status',
+    description: 'Fetch one media request by ID and return its decoded request status, decoded media availability (including 4K), requester, a routing summary, and a next-step hint tuned to the current state. Get the requestId from seerr_request_media (created.requestId) or seerr_list_requests.',
+    annotations: { readOnlyHint: true, openWorldHint: true },
+    input: z.object({
+        requestId: z
+            .number()
+            .int()
+            .positive()
+            .describe('Request ID from seerr_request_media (created.requestId) or seerr_list_requests (requests[].requestId).'),
+    }),
+    output: z.object({
+        requestId: z.number().describe('The request ID.'),
+        mediaType: z.enum(['movie', 'tv']).describe('Movie or TV.'),
+        title: z.string().optional().describe('Title of the requested media when joinable.'),
+        tmdbId: z.number().optional().describe('TMDB ID of the media.'),
+        requestStatus: StatusRef.describe('Decoded request status {raw,label}.'),
+        mediaStatus: StatusRef.optional().describe('Decoded media availability {raw,label}.'),
+        mediaStatus4k: StatusRef.optional().describe('Decoded 4K availability {raw,label} when applicable.'),
+        is4k: z.boolean().describe('Whether this is a 4K request.'),
+        seasons: z.array(z.number()).optional().describe('Requested season numbers (TV).'),
+        requestedBy: z
+            .object({
+            id: z.number().describe('Requester user ID.'),
+            displayName: z.string().describe('Requester display name (no email/tokens).'),
+        })
+            .describe('Who requested it — id + display name only.'),
+        routing: z
+            .object({
+            serverId: z.number().optional().describe('Radarr/Sonarr server ID handling the request.'),
+            profileName: z
+                .string()
+                .optional()
+                .describe('Quality profile name; null when not set on this request.'),
+            is4k: z.boolean().describe('Whether routed to the 4K service.'),
+        })
+            .describe('Routing summary — names/IDs only, no filesystem paths.'),
+        createdAt: z.string().describe('ISO creation timestamp.'),
+        updatedAt: z.string().describe('ISO last-updated timestamp.'),
+        stateGuidance: z
+            .string()
+            .optional()
+            .describe('Recovery/next-step hint tuned to the current status, e.g. pending → "awaiting approval".'),
+    }),
+    errors: [
+        {
+            reason: 'request_not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'No request exists with the given ID (Seerr returns HTTP 404 "Request not found.").',
+            recovery: 'List requests with seerr_list_requests to find a valid requestId, then retry.',
+        },
+    ],
+    async handler(input, ctx) {
+        const seerr = getSeerrService();
+        const raw = await seerr.getRequest(input.requestId, ctx);
+        const detail = projectRequestDetail(raw);
+        ctx.log.info('Seerr request status fetched', {
+            requestId: input.requestId,
+            status: detail.requestStatus.label,
+        });
+        return detail;
+    },
+    format: (result) => {
+        const lines = [];
+        lines.push(`# Request #${result.requestId} — ${result.title ?? 'Untitled'} (${result.mediaType}, 4K=${result.is4k})`);
+        lines.push(`**TMDB ID:** ${result.tmdbId ?? 'n/a'}`);
+        const status = [`**Request:** ${statusText(result.requestStatus)}`];
+        if (result.mediaStatus)
+            status.push(`**Media:** ${statusText(result.mediaStatus)}`);
+        if (result.mediaStatus4k)
+            status.push(`**Media 4K:** ${statusText(result.mediaStatus4k)}`);
+        lines.push(status.join(' | '));
+        lines.push(`**Requested by:** ${result.requestedBy.displayName} (id ${result.requestedBy.id})`);
+        const routing = [`**Routed 4K=${result.routing.is4k}**`];
+        if (result.routing.serverId !== undefined)
+            routing.push(`**Server ID:** ${result.routing.serverId}`);
+        if (result.routing.profileName)
+            routing.push(`**Profile:** ${result.routing.profileName}`);
+        lines.push(routing.join(' | '));
+        if (result.seasons && result.seasons.length > 0)
+            lines.push(`**Seasons:** ${result.seasons.join(', ')}`);
+        const timestamps = [];
+        if (result.createdAt)
+            timestamps.push(`**Created:** ${result.createdAt}`);
+        if (result.updatedAt)
+            timestamps.push(`**Updated:** ${result.updatedAt}`);
+        if (timestamps.length > 0)
+            lines.push(timestamps.join(' | '));
+        if (result.stateGuidance) {
+            lines.push('');
+            lines.push(`> ${result.stateGuidance}`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=request-status.tool.js.map

package/dist/mcp-server/tools/definitions/request-status.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-status.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/request-status.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/search-media.tool.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @fileoverview seerr_search_media — title disambiguation entry point. Wraps
+ * `GET /search`, filters to movie/TV (drops `person`), normalizes each hit, and
+ * decodes `mediaInfo` availability when Seerr already tracks the title. The
+ * required first step before any request. Search-result `mediaInfo` carries only
+ * `status`/`status4k` (no open-request data — that lives on the detail endpoints).
+ * @module mcp-server/tools/definitions/search-media.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const searchMediaTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    query: z.ZodString;
+    mediaType: z.ZodDefault<z.ZodEnum<{
+        movie: "movie";
+        tv: "tv";
+        all: "all";
+    }>>;
+    page: z.ZodDefault<z.ZodNumber>;
+    language: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    results: z.ZodArray<z.ZodObject<{
+        tmdbId: z.ZodNumber;
+        mediaType: z.ZodEnum<{
+            movie: "movie";
+            tv: "tv";
+        }>;
+        title: z.ZodString;
+        year: z.ZodOptional<z.ZodNumber>;
+        overview: z.ZodOptional<z.ZodString>;
+        voteAverage: z.ZodOptional<z.ZodNumber>;
+        tracked: z.ZodBoolean;
+        availability: z.ZodOptional<z.ZodObject<{
+            status: z.ZodObject<{
+                raw: z.ZodNumber;
+                label: z.ZodString;
+            }, z.core.$strip>;
+            status4k: z.ZodOptional<z.ZodObject<{
+                raw: z.ZodNumber;
+                label: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, undefined, {
+    readonly effectiveQuery: z.ZodString;
+    readonly totalCount: z.ZodNumber;
+    readonly truncated: z.ZodOptional<z.ZodBoolean>;
+    readonly shown: z.ZodOptional<z.ZodNumber>;
+    readonly cap: z.ZodOptional<z.ZodNumber>;
+    readonly notice: z.ZodOptional<z.ZodString>;
+}>;
+//# sourceMappingURL=search-media.tool.d.ts.map

package/dist/mcp-server/tools/definitions/search-media.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-media.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-media.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAajD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoL1B,CAAC"}

package/dist/mcp-server/tools/definitions/search-media.tool.js

@@ -0,0 +1,167 @@
+/**
+ * @fileoverview seerr_search_media — title disambiguation entry point. Wraps
+ * `GET /search`, filters to movie/TV (drops `person`), normalizes each hit, and
+ * decodes `mediaInfo` availability when Seerr already tracks the title. The
+ * required first step before any request. Search-result `mediaInfo` carries only
+ * `status`/`status4k` (no open-request data — that lives on the detail endpoints).
+ * @module mcp-server/tools/definitions/search-media.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { redactAvailability } from '../../../services/seerr/normalizers.js';
+import { getSeerrService } from '../../../services/seerr/seerr-service.js';
+import { StatusRef, statusText } from '../../../services/seerr/status.js';
+/** Parse a 4-digit year from an ISO-ish date string; returns undefined when unparseable. */
+function yearOf(date) {
+    if (!date)
+        return;
+    const year = Number.parseInt(date.slice(0, 4), 10);
+    return Number.isFinite(year) ? year : undefined;
+}
+export const searchMediaTool = tool('seerr_search_media', {
+    title: 'seerr-mcp-server: search media',
+    description: 'Search movies and TV shows by title and return ranked matches with TMDB ID, year, overview, and decoded availability status when Seerr already tracks the title. People are always excluded. This is the required first step before requesting media — use the returned tmdbId with seerr_get_media or seerr_request_media.',
+    annotations: { readOnlyHint: true, openWorldHint: true },
+    input: z.object({
+        query: z
+            .string()
+            .min(1)
+            .describe('Title to search for, e.g. "Mulan" or "Severance". Natural-language titles are fine; Seerr matches against TMDB.'),
+        mediaType: z
+            .enum(['movie', 'tv', 'all'])
+            .default('all')
+            .describe('Restrict results to movies, TV shows, or both. People are always excluded — this server requests media, not actors.'),
+        page: z
+            .number()
+            .int()
+            .min(1)
+            .max(1000)
+            .default(1)
+            .describe('1-based result page. Seerr returns ~20 results per page; use with a prior call to page through.'),
+        language: z
+            .string()
+            .regex(/^[a-z]{2}(-[A-Z]{2})?$/)
+            .optional()
+            .describe('ISO 639-1 language for titles/overviews, e.g. "en" or "pt-BR". Defaults to the Seerr instance locale when omitted.'),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(20)
+            .default(10)
+            .describe('Max normalized results to return from this page (caps output size; does not change which page is fetched).'),
+    }),
+    output: z.object({
+        results: z
+            .array(z
+            .object({
+            tmdbId: z
+                .number()
+                .describe('TMDB ID — pass to seerr_get_media or seerr_request_media as tmdbId.'),
+            mediaType: z.enum(['movie', 'tv']).describe('Whether this is a movie or TV show.'),
+            title: z.string().describe('Display title (movie title or show name).'),
+            year: z
+                .number()
+                .optional()
+                .describe('Release year (movies) or first-air year (TV); omitted when the date is unknown.'),
+            overview: z.string().optional().describe('Short synopsis; omitted when TMDB has none.'),
+            voteAverage: z
+                .number()
+                .optional()
+                .describe('TMDB vote average (0–10) for relevance/quality signal.'),
+            tracked: z
+                .boolean()
+                .describe('True when Seerr already tracks this title (mediaInfo present) — availability data follows.'),
+            availability: z
+                .object({
+                status: StatusRef.describe('Decoded media availability {raw,label}.'),
+                status4k: StatusRef.optional().describe('Decoded 4K availability {raw,label} when the instance has 4K enabled.'),
+            })
+                .optional()
+                .describe('Current Seerr availability; present only when tracked is true.'),
+        })
+            .describe('A single ranked movie/TV match.'))
+            .describe('Ranked movie/TV matches. Empty array when nothing matched.'),
+    }),
+    enrichment: {
+        effectiveQuery: z.string().describe('The query as the server parsed it.'),
+        totalCount: z
+            .number()
+            .describe('Total results Seerr reported for the query before this page limit.'),
+        truncated: z
+            .boolean()
+            .optional()
+            .describe('True when this page yielded more results than the limit returned.'),
+        shown: z.number().optional().describe('Number of results returned after the limit.'),
+        cap: z.number().optional().describe('The limit that was applied.'),
+        notice: z.string().optional().describe('Guidance when nothing matched.'),
+    },
+    async handler(input, ctx) {
+        const seerr = getSeerrService();
+        const response = await seerr.search({
+            query: input.query,
+            page: input.page,
+            ...(input.language ? { language: input.language } : {}),
+        }, ctx);
+        const wanted = (input.mediaType === 'all' ? ['movie', 'tv'] : [input.mediaType]);
+        const matches = (response.results ?? [])
+            .filter((r) => r.mediaType === 'movie' || r.mediaType === 'tv')
+            .filter((r) => wanted.includes(r.mediaType));
+        const limited = matches.slice(0, input.limit);
+        const results = limited.map((r) => {
+            const isMovie = r.mediaType === 'movie';
+            const tracked = r.mediaInfo !== undefined;
+            return {
+                tmdbId: r.id,
+                mediaType: r.mediaType,
+                title: (isMovie ? r.title : r.name) ?? '',
+                ...(yearOf(isMovie ? r.releaseDate : r.firstAirDate) !== undefined
+                    ? { year: yearOf(isMovie ? r.releaseDate : r.firstAirDate) }
+                    : {}),
+                ...(r.overview?.trim() ? { overview: r.overview.trim() } : {}),
+                ...(typeof r.voteAverage === 'number' ? { voteAverage: r.voteAverage } : {}),
+                tracked,
+                ...(tracked && r.mediaInfo ? { availability: redactAvailability(r.mediaInfo) } : {}),
+            };
+        });
+        ctx.enrich.echo(input.query);
+        ctx.enrich.total(response.totalResults ?? matches.length);
+        if (matches.length > input.limit) {
+            ctx.enrich.truncated({ shown: results.length, cap: input.limit });
+        }
+        if (results.length === 0) {
+            ctx.enrich.notice(`No movie/TV match for "${input.query}". Try a different spelling or broaden mediaType to "all".`);
+        }
+        ctx.log.info('Seerr search completed', {
+            query: input.query,
+            matched: matches.length,
+            returned: results.length,
+        });
+        return { results };
+    },
+    format: (result) => {
+        if (result.results.length === 0) {
+            return [{ type: 'text', text: 'No matching movies or TV shows.' }];
+        }
+        const lines = [];
+        for (const r of result.results) {
+            const yearPart = r.year !== undefined ? ` (${r.year})` : '';
+            lines.push(`## ${r.title}${yearPart} — ${r.mediaType}`);
+            const facts = [`**TMDB ID:** ${r.tmdbId}`];
+            if (r.voteAverage !== undefined)
+                facts.push(`**Rating:** ${r.voteAverage.toFixed(1)}/10`);
+            facts.push(`**Tracked by Seerr:** ${r.tracked ? 'Yes' : 'No'}`);
+            lines.push(facts.join(' | '));
+            if (r.availability) {
+                const fourK = r.availability.status4k
+                    ? ` | 4K: ${statusText(r.availability.status4k)}`
+                    : '';
+                lines.push(`**Availability:** ${statusText(r.availability.status)}${fourK}`);
+            }
+            if (r.overview)
+                lines.push(r.overview);
+            lines.push('');
+        }
+        return [{ type: 'text', text: lines.join('\n').trimEnd() }];
+    },
+});
+//# sourceMappingURL=search-media.tool.js.map

package/dist/mcp-server/tools/definitions/search-media.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-media.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-media.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/service-options.tool.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @fileoverview seerr_service_options — let an agent reason about request
+ * capability and routing without a separate status tool. Summarizes configured
+ * Radarr/Sonarr services + default quality profiles, folds in compact Seerr
+ * version and public feature flags (4K, partial requests, specials). Filesystem
+ * paths (root folders, `activeDirectory`/`activeAnimeDirectory`) are redacted
+ * unless `includePaths: true`; `vapidPublic` and `plexClientIdentifier` from
+ * `/settings/public` are never surfaced. Legs fan out with `Promise.allSettled`
+ * so one failure degrades to a notice rather than failing the call.
+ * @module mcp-server/tools/definitions/service-options.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const serviceOptionsTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    service: z.ZodDefault<z.ZodEnum<{
+        all: "all";
+        radarr: "radarr";
+        sonarr: "sonarr";
+    }>>;
+    includePaths: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    instance: z.ZodObject<{
+        version: z.ZodString;
+        mediaServer: z.ZodString;
+        movie4kEnabled: z.ZodBoolean;
+        series4kEnabled: z.ZodBoolean;
+        partialRequestsEnabled: z.ZodBoolean;
+        specialEpisodesEnabled: z.ZodBoolean;
+    }, z.core.$strip>;
+    services: z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<{
+            radarr: "radarr";
+            sonarr: "sonarr";
+        }>;
+        serverId: z.ZodNumber;
+        name: z.ZodString;
+        isDefault: z.ZodBoolean;
+        is4k: z.ZodBoolean;
+        activeProfileId: z.ZodNumber;
+        profiles: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodNumber;
+            name: z.ZodString;
+        }, z.core.$strip>>>;
+        rootFolders: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            freeSpace: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, undefined, {
+    readonly notice: z.ZodOptional<z.ZodString>;
+}>;
+//# sourceMappingURL=service-options.tool.d.ts.map

package/dist/mcp-server/tools/definitions/service-options.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-options.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/service-options.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAoEjD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2K7B,CAAC"}

package/dist/mcp-server/tools/definitions/service-options.tool.js

@@ -0,0 +1,195 @@
+/**
+ * @fileoverview seerr_service_options — let an agent reason about request
+ * capability and routing without a separate status tool. Summarizes configured
+ * Radarr/Sonarr services + default quality profiles, folds in compact Seerr
+ * version and public feature flags (4K, partial requests, specials). Filesystem
+ * paths (root folders, `activeDirectory`/`activeAnimeDirectory`) are redacted
+ * unless `includePaths: true`; `vapidPublic` and `plexClientIdentifier` from
+ * `/settings/public` are never surfaced. Legs fan out with `Promise.allSettled`
+ * so one failure degrades to a notice rather than failing the call.
+ * @module mcp-server/tools/definitions/service-options.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { redactProfile, redactRootFolder } from '../../../services/seerr/normalizers.js';
+import { getSeerrService } from '../../../services/seerr/seerr-service.js';
+import { decodeMediaServer } from '../../../services/seerr/status.js';
+/**
+ * Build one service summary: always fetches the detail endpoint for profile names;
+ * includes root folders only when `includePaths`. A failed detail leg is recorded
+ * as a warning and the profiles/folders are omitted (degraded, but honest).
+ */
+async function buildService(kind, entry, includePaths, seerr, ctx, warnings) {
+    const base = {
+        kind,
+        serverId: entry.id,
+        name: entry.name ?? `${kind} ${entry.id}`,
+        isDefault: entry.isDefault === true,
+        is4k: entry.is4k === true,
+        activeProfileId: entry.activeProfileId ?? 0,
+    };
+    let detail;
+    try {
+        detail =
+            kind === 'radarr'
+                ? await seerr.getRadarrDetail(entry.id, ctx)
+                : await seerr.getSonarrDetail(entry.id, ctx);
+    }
+    catch {
+        warnings.push(`${kind === 'radarr' ? 'Radarr' : 'Sonarr'} details unavailable for server ${entry.id}; profile list omitted.`);
+        return base;
+    }
+    const profiles = (detail.profiles ?? []).map(redactProfile);
+    const rootFolders = includePaths
+        ? (detail.rootFolders ?? [])
+            .map((f) => redactRootFolder(f, includePaths))
+            .filter((f) => f !== undefined)
+        : undefined;
+    return {
+        ...base,
+        ...(profiles.length > 0 ? { profiles } : {}),
+        ...(rootFolders ? { rootFolders } : {}),
+    };
+}
+export const serviceOptionsTool = tool('seerr_service_options', {
+    title: 'seerr-mcp-server: service options',
+    description: 'Summarize the configured Radarr (movie) and Sonarr (TV) services, their default quality profiles, and the Seerr instance capability flags (4K, partial requests, specials, media server) so an agent can reason about what kinds of requests will be accepted and how routing works. Filesystem paths are redacted unless includePaths is set.',
+    annotations: { readOnlyHint: true, openWorldHint: true },
+    input: z.object({
+        service: z
+            .enum(['radarr', 'sonarr', 'all'])
+            .default('all')
+            .describe('Which service(s) to summarize. "all" covers both movie (Radarr) and TV (Sonarr) routing.'),
+        includePaths: z
+            .boolean()
+            .default(false)
+            .describe('Include filesystem root-folder paths and free space. Default false redacts paths (operator-private). Set true only when you explicitly need routing paths.'),
+    }),
+    output: z.object({
+        instance: z
+            .object({
+            version: z.string().describe('Seerr version, e.g. "3.3.0".'),
+            mediaServer: z.string().describe('Decoded media server: "plex" | "jellyfin" | "emby".'),
+            movie4kEnabled: z.boolean().describe('Whether 4K movie requests are allowed.'),
+            series4kEnabled: z.boolean().describe('Whether 4K TV requests are allowed.'),
+            partialRequestsEnabled: z.boolean().describe('Whether per-season TV requests are allowed.'),
+            specialEpisodesEnabled: z
+                .boolean()
+                .describe('Whether season 0 (Specials) can be requested.'),
+        })
+            .describe('Instance capability summary — what kinds of requests will be accepted.'),
+        services: z
+            .array(z
+            .object({
+            kind: z
+                .enum(['radarr', 'sonarr'])
+                .describe('Service type — Radarr (movies) or Sonarr (TV).'),
+            serverId: z
+                .number()
+                .describe('Server ID — pass to seerr_request_media serverId to override routing.'),
+            name: z.string().describe('Service display name.'),
+            isDefault: z
+                .boolean()
+                .describe('Whether this is the default server for its media type.'),
+            is4k: z.boolean().describe('Whether this server handles 4K.'),
+            activeProfileId: z
+                .number()
+                .describe('Default quality profile ID — pass as profileId to override.'),
+            profiles: z
+                .array(z
+                .object({
+                id: z.number().describe('Quality profile ID for profileId overrides.'),
+                name: z.string().describe('Quality profile name, e.g. "HD-1080p", "Ultra-HD".'),
+            })
+                .describe('A configured quality profile.'))
+                .optional()
+                .describe('Available quality profiles (from the detail endpoint).'),
+            rootFolders: z
+                .array(z
+                .object({
+                path: z
+                    .string()
+                    .describe('Root folder path — only present when includePaths is true.'),
+                freeSpace: z
+                    .number()
+                    .optional()
+                    .describe('Free space in bytes (raw API field name: freeSpace) — only when includePaths is true.'),
+            })
+                .describe('A configured root folder.'))
+                .optional()
+                .describe('Root folders — omitted unless includePaths is true (paths are operator-private).'),
+        })
+            .describe('A configured Radarr or Sonarr service with its routing defaults.'))
+            .describe('Configured Radarr/Sonarr services with routing defaults.'),
+    }),
+    enrichment: {
+        notice: z
+            .string()
+            .optional()
+            .describe('Disclosure when a service leg failed and its data was omitted.'),
+    },
+    async handler(input, ctx) {
+        const seerr = getSeerrService();
+        const wantRadarr = input.service === 'radarr' || input.service === 'all';
+        const wantSonarr = input.service === 'sonarr' || input.service === 'all';
+        const warnings = [];
+        const [statusRes, settingsRes, radarrListRes, sonarrListRes] = await Promise.allSettled([
+            seerr.getStatus(ctx),
+            seerr.getPublicSettings(ctx),
+            wantRadarr ? seerr.getRadarrServices(ctx) : Promise.resolve([]),
+            wantSonarr ? seerr.getSonarrServices(ctx) : Promise.resolve([]),
+        ]);
+        const settings = settingsRes.status === 'fulfilled' ? settingsRes.value : {};
+        if (settingsRes.status === 'rejected')
+            warnings.push('Instance settings unavailable; capability flags may be incomplete.');
+        if (statusRes.status === 'rejected')
+            warnings.push('Seerr version unavailable.');
+        const instance = {
+            version: statusRes.status === 'fulfilled' ? (statusRes.value.version ?? 'unknown') : 'unknown',
+            mediaServer: decodeMediaServer(settings.mediaServerType ?? 0),
+            movie4kEnabled: settings.movie4kEnabled === true,
+            series4kEnabled: settings.series4kEnabled === true,
+            partialRequestsEnabled: settings.partialRequestsEnabled === true,
+            specialEpisodesEnabled: settings.enableSpecialEpisodes === true,
+        };
+        const radarrList = radarrListRes.status === 'fulfilled' ? radarrListRes.value : [];
+        if (wantRadarr && radarrListRes.status === 'rejected')
+            warnings.push('Radarr service list unavailable.');
+        const sonarrList = sonarrListRes.status === 'fulfilled' ? sonarrListRes.value : [];
+        if (wantSonarr && sonarrListRes.status === 'rejected')
+            warnings.push('Sonarr service list unavailable.');
+        const services = await Promise.all([
+            ...radarrList.map((entry) => buildService('radarr', entry, input.includePaths, seerr, ctx, warnings)),
+            ...sonarrList.map((entry) => buildService('sonarr', entry, input.includePaths, seerr, ctx, warnings)),
+        ]);
+        if (warnings.length > 0)
+            ctx.enrich.notice(warnings.join(' '));
+        ctx.log.info('Seerr service options assembled', {
+            service: input.service,
+            serviceCount: services.length,
+            warnings: warnings.length,
+        });
+        return { instance, services };
+    },
+    format: (result) => {
+        const lines = [];
+        const i = result.instance;
+        lines.push(`# Seerr ${i.version} — ${i.mediaServer}`);
+        lines.push(`**4K movies:** ${i.movie4kEnabled} | **4K series:** ${i.series4kEnabled} | **Partial requests:** ${i.partialRequestsEnabled} | **Specials:** ${i.specialEpisodesEnabled}`);
+        for (const s of result.services) {
+            lines.push('');
+            lines.push(`## ${s.name} — ${s.kind}${s.isDefault ? ' [default]' : ''}`);
+            lines.push(`**Server ID:** ${s.serverId} | **4K:** ${s.is4k ? 'Yes' : 'No'} | **Default profile ID:** ${s.activeProfileId}`);
+            if (s.profiles && s.profiles.length > 0) {
+                lines.push(`**Profiles:** ${s.profiles.map((p) => `${p.name} (#${p.id})`).join(', ')}`);
+            }
+            if (s.rootFolders && s.rootFolders.length > 0) {
+                for (const f of s.rootFolders) {
+                    const free = f.freeSpace !== undefined ? ` — freeSpace ${f.freeSpace} bytes` : '';
+                    lines.push(`**Root folder:** ${f.path}${free}`);
+                }
+            }
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=service-options.tool.js.map

package/dist/mcp-server/tools/definitions/service-options.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-options.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/service-options.tool.ts"],"names":[],"mappings":"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"}