@cyanheads/seerr-mcp-server 0.1.0

package/dist/services/seerr/seerr-service.js

@@ -0,0 +1,187 @@
+/**
+ * @fileoverview SeerrService — the typed client for the Seerr REST API v1
+ * (`{SEERR_BASE_URL}/api/v1`, `X-Api-Key` auth). One upstream API, one service,
+ * init/accessor pattern. Every method wraps a single-attempt fetch + parse in
+ * `withRetry` (the retry boundary covers the full pipeline). Not-found-bearing GETs
+ * (movie/tv/request) route their non-OK responses through the `errors.ts` classifier
+ * so Seerr's idiosyncratic 500/404 not-found bodies become clean domain errors.
+ *
+ * The instance is a trusted local LAN / Tailscale host, so requests use plain
+ * `fetch` (the framework's `fetchWithTimeout` SSRF guard would block the private
+ * IP, and the classifier needs body access on non-OK). The base URL and API key
+ * never leave this file's request construction — no method returns them.
+ * @module services/seerr/seerr-service
+ */
+import { serializationError } from '@cyanheads/mcp-ts-core/errors';
+import { withRetry } from '@cyanheads/mcp-ts-core/utils';
+import { getServerConfig } from '../../config/server-config.js';
+import { throwClassifiedSeerrError } from './errors.js';
+const SERVICE_NAME = 'Seerr';
+const SETTINGS_CACHE_KEY = 'seerr:settings:public';
+const SETTINGS_CACHE_TTL_SECONDS = 300;
+export class SeerrService {
+    baseUrl;
+    apiKey;
+    timeoutMs;
+    constructor() {
+        const server = getServerConfig();
+        this.baseUrl = `${server.baseUrl.replace(/\/+$/, '')}/api/v1`;
+        this.apiKey = server.apiKey;
+        this.timeoutMs = server.requestTimeoutMs;
+    }
+    /* ------------------------------------------------------------------ *
+     * Search + media detail
+     * ------------------------------------------------------------------ */
+    /** `GET /search` — title disambiguation. */
+    search(params, ctx) {
+        const qs = new URLSearchParams({ query: params.query, page: String(params.page) });
+        if (params.language)
+            qs.set('language', params.language);
+        return this.request(`/search?${qs.toString()}`, ctx);
+    }
+    /** `GET /movie/{id}` — movie detail. 500 "Unable to retrieve movie." → media_not_found. */
+    getMovie(tmdbId, ctx) {
+        return this.request(`/movie/${tmdbId}`, ctx, { notFoundKind: 'media' });
+    }
+    /** `GET /tv/{id}` — TV detail. */
+    getTv(tmdbId, ctx) {
+        return this.request(`/tv/${tmdbId}`, ctx, { notFoundKind: 'media' });
+    }
+    /** `GET /tv/{id}/season/{n}` — episode list for one season. */
+    getSeason(tmdbId, seasonNumber, ctx) {
+        return this.request(`/tv/${tmdbId}/season/${seasonNumber}`, ctx, {
+            notFoundKind: 'media',
+        });
+    }
+    /* ------------------------------------------------------------------ *
+     * Requests
+     * ------------------------------------------------------------------ */
+    /** `GET /request` — list requests with filters. */
+    listRequests(params, ctx) {
+        const qs = new URLSearchParams({
+            take: String(params.take),
+            skip: String(params.skip),
+            filter: params.filter,
+            sort: params.sort,
+            sortDirection: params.sortDirection,
+        });
+        if (params.mediaType && params.mediaType !== 'all')
+            qs.set('mediaType', params.mediaType);
+        if (typeof params.requestedById === 'number')
+            qs.set('requestedBy', String(params.requestedById));
+        return this.request(`/request?${qs.toString()}`, ctx);
+    }
+    /** `GET /request/{id}` — single request. 404 "Request not found." → request_not_found. */
+    getRequest(requestId, ctx) {
+        return this.request(`/request/${requestId}`, ctx, {
+            notFoundKind: 'request',
+        });
+    }
+    /** `POST /request` — create a media request. The only write in the surface. */
+    createRequest(body, ctx) {
+        return this.request('/request', ctx, { method: 'POST', body });
+    }
+    /* ------------------------------------------------------------------ *
+     * Services + settings
+     * ------------------------------------------------------------------ */
+    /** `GET /service/radarr` — Radarr service list. */
+    getRadarrServices(ctx) {
+        return this.request('/service/radarr', ctx);
+    }
+    /** `GET /service/radarr/{id}` — Radarr profiles + root folders. */
+    getRadarrDetail(serverId, ctx) {
+        return this.request(`/service/radarr/${serverId}`, ctx);
+    }
+    /** `GET /service/sonarr` — Sonarr service list. */
+    getSonarrServices(ctx) {
+        return this.request('/service/sonarr', ctx);
+    }
+    /** `GET /service/sonarr/{id}` — Sonarr profiles + root folders. */
+    getSonarrDetail(serverId, ctx) {
+        return this.request(`/service/sonarr/${serverId}`, ctx);
+    }
+    /** `GET /status` — Seerr version. */
+    getStatus(ctx) {
+        return this.request('/status', ctx);
+    }
+    /**
+     * `GET /settings/public` — capability flags. Cached in `ctx.state` with a short
+     * TTL: capability checks read it on most calls (preview validation, search/get
+     * 4K decoding) but instance config changes rarely. Cache failures are non-fatal.
+     */
+    async getPublicSettings(ctx, options = {}) {
+        if (!options.forceRefresh) {
+            const cached = await ctx.state.get(SETTINGS_CACHE_KEY).catch(() => null);
+            if (cached)
+                return cached;
+        }
+        const settings = await this.request('/settings/public', ctx);
+        await ctx.state
+            .set(SETTINGS_CACHE_KEY, settings, { ttl: SETTINGS_CACHE_TTL_SECONDS })
+            .catch(() => { });
+        return settings;
+    }
+    /* ------------------------------------------------------------------ *
+     * Core request pipeline
+     * ------------------------------------------------------------------ */
+    /**
+     * Single Seerr request: fetch (single attempt) + status check + JSON parse, all
+     * inside `withRetry`. Non-OK responses route through the not-found classifier
+     * (when `notFoundKind` is set) or the framework's status mapping. The retry
+     * boundary wraps the whole pipeline so a transient parse failure also retries.
+     */
+    request(path, ctx, options = {}) {
+        const url = `${this.baseUrl}${path}`;
+        const method = options.method ?? 'GET';
+        return withRetry(async () => {
+            const headers = {
+                'X-Api-Key': this.apiKey,
+                Accept: 'application/json',
+            };
+            if (options.body !== undefined)
+                headers['Content-Type'] = 'application/json';
+            const response = await fetch(url, {
+                method,
+                headers,
+                ...(options.body !== undefined ? { body: JSON.stringify(options.body) } : {}),
+                signal: AbortSignal.any([ctx.signal, AbortSignal.timeout(this.timeoutMs)]),
+            });
+            if (!response.ok) {
+                await throwClassifiedSeerrError(response, options.notFoundKind ?? 'media', SERVICE_NAME);
+            }
+            const text = await response.text();
+            if (text.length === 0)
+                return undefined;
+            try {
+                return JSON.parse(text);
+            }
+            catch (cause) {
+                throw serializationError(`${SERVICE_NAME} returned a non-JSON response.`, { path }, { cause });
+            }
+        }, {
+            operation: `SeerrService.request ${method} ${path}`,
+            context: { requestId: ctx.requestId, timestamp: ctx.timestamp },
+            baseDelayMs: options.baseDelayMs ?? 300,
+            signal: ctx.signal,
+        });
+    }
+}
+/* --- Init/accessor pattern --- */
+let _service;
+/**
+ * Initialize the singleton SeerrService — called from `createApp`'s `setup()`.
+ * Config and storage are accepted to match the framework's init signature; the
+ * service reads its own env config via `getServerConfig()` and uses tenant-scoped
+ * `ctx.state` (not the raw storage handle) for the settings cache.
+ */
+export function initSeerrService(_config, _storage) {
+    _service = new SeerrService();
+}
+/** Accessor for the SeerrService singleton. Throws if `initSeerrService` was not called. */
+export function getSeerrService() {
+    if (!_service) {
+        throw new Error('SeerrService not initialized — call initSeerrService() in setup()');
+    }
+    return _service;
+}
+//# sourceMappingURL=seerr-service.js.map

package/dist/services/seerr/seerr-service.js.map

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

package/dist/services/seerr/status.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @fileoverview Pure status decoders for Seerr's numeric status enums. Every tool
+ * output that carries a request status, media availability, or media-server type
+ * emits a decoded `{ raw, label }` object via these helpers — never a bare number
+ * or bare string. Unknown codes degrade to `{ raw, label: 'unrecognized' }` rather
+ * than throwing, so a future Seerr status code still surfaces its raw value.
+ * @module services/seerr/status
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+/**
+ * Shared Zod shape for a decoded status. Reused across every tool output and the
+ * resource so the `{ raw, label }` contract is identical everywhere.
+ */
+export declare const StatusRef: z.ZodObject<{
+    raw: z.ZodNumber;
+    label: z.ZodString;
+}, z.core.$strip>;
+export type DecodedStatus = z.infer<typeof StatusRef>;
+/** Decode a `MediaRequest.status` numeric code to `{ raw, label }`. */
+export declare function decodeRequestStatus(raw: number): DecodedStatus;
+/** Decode a `MediaInfo.status` / `status4k` numeric code to `{ raw, label }`. */
+export declare function decodeMediaStatus(raw: number): DecodedStatus;
+/** Decode a `mediaServerType` setting code to its label (plex | jellyfin | emby | unrecognized). */
+export declare function decodeMediaServer(raw: number): string;
+/** Render a decoded status for `format()` output as `label (raw)` — surfaces both halves so format-parity holds. */
+export declare function statusText(status: DecodedStatus): string;
+//# sourceMappingURL=status.d.ts.map

package/dist/services/seerr/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/services/seerr/status.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAE3C;;;GAGG;AACH,eAAO,MAAM,SAAS;;;iBAK4D,CAAC;AAEnF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAuCtD,uEAAuE;AACvE,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAE9D;AAED,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAE5D;AAED,oGAAoG;AACpG,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,oHAAoH;AACpH,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAExD"}

package/dist/services/seerr/status.js

@@ -0,0 +1,70 @@
+/**
+ * @fileoverview Pure status decoders for Seerr's numeric status enums. Every tool
+ * output that carries a request status, media availability, or media-server type
+ * emits a decoded `{ raw, label }` object via these helpers — never a bare number
+ * or bare string. Unknown codes degrade to `{ raw, label: 'unrecognized' }` rather
+ * than throwing, so a future Seerr status code still surfaces its raw value.
+ * @module services/seerr/status
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+/**
+ * Shared Zod shape for a decoded status. Reused across every tool output and the
+ * resource so the `{ raw, label }` contract is identical everywhere.
+ */
+export const StatusRef = z
+    .object({
+    raw: z.number().describe('Raw numeric status code from the Seerr API.'),
+    label: z.string().describe('Human-readable decoded label for the status code.'),
+})
+    .describe('Decoded status: the raw numeric code plus its human-readable label.');
+/**
+ * `MediaRequest.status` codes (request lifecycle). Matches Jellyseerr/Seerr's
+ * `MediaRequestStatus` enum. Live Seerr 3.3.0 emits 4 (failed) and 5 (completed)
+ * on real requests — over half the requests on a working instance are status 5 —
+ * so decoding only 1-3 mislabels every completed/failed request as `unrecognized`.
+ */
+const REQUEST_STATUS_LABELS = {
+    1: 'pending',
+    2: 'approved',
+    3: 'declined',
+    4: 'failed',
+    5: 'completed',
+};
+/**
+ * `MediaInfo.status` / `MediaInfo.status4k` codes (availability lifecycle). Matches
+ * Jellyseerr/Seerr's `MediaStatus` enum: 6 is `blocklisted` and 7 is `deleted`
+ * (BLOCKLISTED was inserted at 6, shifting DELETED to 7) — mapping 6 to `deleted`
+ * mislabels a blocklisted item and leaves an actually-deleted item `unrecognized`.
+ */
+const MEDIA_STATUS_LABELS = {
+    1: 'unknown',
+    2: 'pending',
+    3: 'processing',
+    4: 'partially_available',
+    5: 'available',
+    6: 'blocklisted',
+    7: 'deleted',
+};
+/** `mediaServerType` setting codes. */
+const MEDIA_SERVER_LABELS = {
+    1: 'plex',
+    2: 'jellyfin',
+    3: 'emby',
+};
+/** Decode a `MediaRequest.status` numeric code to `{ raw, label }`. */
+export function decodeRequestStatus(raw) {
+    return { raw, label: REQUEST_STATUS_LABELS[raw] ?? 'unrecognized' };
+}
+/** Decode a `MediaInfo.status` / `status4k` numeric code to `{ raw, label }`. */
+export function decodeMediaStatus(raw) {
+    return { raw, label: MEDIA_STATUS_LABELS[raw] ?? 'unrecognized' };
+}
+/** Decode a `mediaServerType` setting code to its label (plex | jellyfin | emby | unrecognized). */
+export function decodeMediaServer(raw) {
+    return MEDIA_SERVER_LABELS[raw] ?? 'unrecognized';
+}
+/** Render a decoded status for `format()` output as `label (raw)` — surfaces both halves so format-parity holds. */
+export function statusText(status) {
+    return `${status.label} (${status.raw})`;
+}
+//# sourceMappingURL=status.js.map

package/dist/services/seerr/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../src/services/seerr/status.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAE3C;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC;KACvB,MAAM,CAAC;IACN,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;IACvE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;CAChF,CAAC;KACD,QAAQ,CAAC,qEAAqE,CAAC,CAAC;AAInF;;;;;GAKG;AACH,MAAM,qBAAqB,GAA2B;IACpD,CAAC,EAAE,SAAS;IACZ,CAAC,EAAE,UAAU;IACb,CAAC,EAAE,UAAU;IACb,CAAC,EAAE,QAAQ;IACX,CAAC,EAAE,WAAW;CACf,CAAC;AAEF;;;;;GAKG;AACH,MAAM,mBAAmB,GAA2B;IAClD,CAAC,EAAE,SAAS;IACZ,CAAC,EAAE,SAAS;IACZ,CAAC,EAAE,YAAY;IACf,CAAC,EAAE,qBAAqB;IACxB,CAAC,EAAE,WAAW;IACd,CAAC,EAAE,aAAa;IAChB,CAAC,EAAE,SAAS;CACb,CAAC;AAEF,uCAAuC;AACvC,MAAM,mBAAmB,GAA2B;IAClD,CAAC,EAAE,MAAM;IACT,CAAC,EAAE,UAAU;IACb,CAAC,EAAE,MAAM;CACV,CAAC;AAEF,uEAAuE;AACvE,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC7C,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,qBAAqB,CAAC,GAAG,CAAC,IAAI,cAAc,EAAE,CAAC;AACtE,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,mBAAmB,CAAC,GAAG,CAAC,IAAI,cAAc,EAAE,CAAC;AACpE,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,OAAO,mBAAmB,CAAC,GAAG,CAAC,IAAI,cAAc,CAAC;AACpD,CAAC;AAED,oHAAoH;AACpH,MAAM,UAAU,UAAU,CAAC,MAAqB;IAC9C,OAAO,GAAG,MAAM,CAAC,KAAK,KAAK,MAAM,CAAC,GAAG,GAAG,CAAC;AAC3C,CAAC"}

package/dist/services/seerr/types.d.ts

@@ -0,0 +1,221 @@
+/**
+ * @fileoverview Raw upstream Seerr API types (hand-written from the OpenAPI spec +
+ * live read-only probes against Seerr 3.3.0) and the normalized domain types this
+ * server exposes. Raw types default to optional unless the live payload guarantees
+ * presence — third-party APIs omit fields rather than nulling them, and over-strict
+ * raw types either fail validation or invent facts. The domain types are the
+ * PII-redacted projections produced by `normalizers.ts`.
+ * @module services/seerr/types
+ */
+/**
+ * Raw Seerr `User` object. Nested in `requestedBy` AND `modifiedBy` on requests.
+ * Carries heavy PII — email, Plex/Jellyfin tokens and IDs, quotas, avatar,
+ * permissions bitfield. `normalizers.ts` projects it to `{ id, displayName }`;
+ * nothing else here may reach tool output.
+ */
+export interface RawUser {
+    avatar?: string;
+    displayName?: string;
+    email?: string;
+    id: number;
+    jellyfinUserId?: string;
+    jellyfinUsername?: string;
+    permissions?: number;
+    plexId?: number;
+    plexUsername?: string;
+    username?: string;
+    [key: string]: unknown;
+}
+/**
+ * Raw `MediaInfo` nested on search results, movie/TV detail, and request `media`.
+ * Leaks `serviceUrl`/`serviceUrl4k` (internal host:port), `jellyfinMediaId`,
+ * `ratingKey`, etc. — only `status`/`status4k`/`tmdbId`/`mediaType` are read.
+ * `requests[]` is present ONLY on movie/TV detail, never on search results.
+ */
+export interface RawMediaInfo {
+    id?: number;
+    mediaType?: string;
+    requests?: RawMediaRequest[];
+    serviceUrl?: string;
+    serviceUrl4k?: string;
+    status?: number;
+    status4k?: number;
+    tmdbId?: number;
+    [key: string]: unknown;
+}
+/**
+ * Raw `MediaRequest`. The media-type discriminator is `type` (not `mediaType`).
+ * `profileName` is present at the list endpoint but ABSENT at `GET /request/{id}`.
+ * Both `requestedBy` and `modifiedBy` are full `RawUser` objects.
+ */
+export interface RawMediaRequest {
+    createdAt?: string;
+    id: number;
+    is4k?: boolean;
+    isAutoRequest?: boolean;
+    languageProfileId?: number | null;
+    media?: RawMediaInfo;
+    modifiedBy?: RawUser;
+    profileId?: number;
+    profileName?: string | null;
+    requestedBy?: RawUser;
+    rootFolder?: string | null;
+    seasonCount?: number;
+    seasons?: Array<{
+        seasonNumber?: number;
+    } | number>;
+    serverId?: number;
+    status?: number;
+    type?: string;
+    updatedAt?: string;
+    [key: string]: unknown;
+}
+/** Raw search-result hit (`MovieResult` | `TvResult`); `person` is filtered out upstream of this. */
+export interface RawSearchResult {
+    firstAirDate?: string;
+    id: number;
+    mediaInfo?: RawMediaInfo;
+    mediaType?: string;
+    name?: string;
+    overview?: string;
+    releaseDate?: string;
+    title?: string;
+    voteAverage?: number;
+    [key: string]: unknown;
+}
+/** Raw `/search` response envelope (flat — distinct from the request-list `pageInfo` envelope). */
+export interface RawSearchResponse {
+    page?: number;
+    results?: RawSearchResult[];
+    totalPages?: number;
+    totalResults?: number;
+}
+/** Raw season summary on TV detail (`seasons[]`). */
+export interface RawSeason {
+    airDate?: string | null;
+    episodeCount?: number;
+    id?: number;
+    name?: string;
+    overview?: string;
+    seasonNumber?: number;
+    [key: string]: unknown;
+}
+/** Raw episode on a season detail (`/tv/{id}/season/{n}` → `episodes[]`). */
+export interface RawEpisode {
+    airDate?: string | null;
+    episodeNumber?: number;
+    id?: number;
+    name?: string;
+    overview?: string;
+    [key: string]: unknown;
+}
+/** Raw movie detail (`GET /movie/{id}`). */
+export interface RawMovieDetail {
+    id: number;
+    mediaInfo?: RawMediaInfo;
+    overview?: string;
+    releaseDate?: string;
+    runtime?: number;
+    status?: string;
+    title?: string;
+    [key: string]: unknown;
+}
+/** Raw TV detail (`GET /tv/{id}`). Live API uses `numberOfSeasons` (plural). */
+export interface RawTvDetail {
+    firstAirDate?: string;
+    id: number;
+    mediaInfo?: RawMediaInfo;
+    name?: string;
+    numberOfSeasons?: number;
+    overview?: string;
+    seasons?: RawSeason[];
+    status?: string;
+    [key: string]: unknown;
+}
+/** Raw season detail (`GET /tv/{id}/season/{n}`). */
+export interface RawSeasonDetail {
+    episodes?: RawEpisode[];
+    id?: number;
+    name?: string;
+    seasonNumber?: number;
+    [key: string]: unknown;
+}
+/** Raw request-list envelope (`{ pageInfo, results, serviceErrors }`). */
+export interface RawRequestListResponse {
+    pageInfo?: {
+        page?: number;
+        pages?: number;
+        pageSize?: number;
+        results?: number;
+    };
+    results?: RawMediaRequest[];
+}
+/** Raw `/settings/public`. Drives capability + validation; `vapidPublic`/`plexClientIdentifier` are stripped from output. */
+export interface RawPublicSettings {
+    applicationTitle?: string;
+    enableSpecialEpisodes?: boolean;
+    mediaServerType?: number;
+    movie4kEnabled?: boolean;
+    partialRequestsEnabled?: boolean;
+    series4kEnabled?: boolean;
+    [key: string]: unknown;
+}
+/** Raw `/status`. */
+export interface RawStatus {
+    version?: string;
+    [key: string]: unknown;
+}
+/** Raw Radarr/Sonarr list entry. Leaks `activeDirectory` (+ `activeAnimeDirectory` on Sonarr). */
+export interface RawServiceListEntry {
+    activeAnimeDirectory?: string;
+    activeAnimeProfileId?: number;
+    activeDirectory?: string;
+    activeProfileId?: number;
+    id: number;
+    is4k?: boolean;
+    isDefault?: boolean;
+    name?: string;
+    [key: string]: unknown;
+}
+/** Raw quality profile (`{ id, name }`) from a service detail endpoint. */
+export interface RawServiceProfile {
+    id: number;
+    name?: string;
+    [key: string]: unknown;
+}
+/** Raw root folder from a service detail endpoint (`freeSpace`, not `freeSpaceBytes`). */
+export interface RawRootFolder {
+    freeSpace?: number;
+    id?: number;
+    path?: string;
+    [key: string]: unknown;
+}
+/** Raw service detail (`/service/radarr/{id}` | `/service/sonarr/{id}`). `profiles` is an array. */
+export interface RawServiceDetail {
+    languageProfiles?: unknown;
+    profiles?: RawServiceProfile[];
+    rootFolders?: RawRootFolder[];
+    server?: RawServiceListEntry;
+    [key: string]: unknown;
+}
+/**
+ * Body submitted to `POST /request`. Also the `payload` surfaced in preview output,
+ * so `is4k` is always present (the tool sets it explicitly). `userId` is
+ * intentionally never set — the request is made as the API key's user.
+ */
+export interface CreateRequestBody {
+    is4k: boolean;
+    languageProfileId?: number;
+    mediaId: number;
+    mediaType: 'movie' | 'tv';
+    profileId?: number;
+    rootFolder?: string;
+    seasons?: number[] | 'all';
+    serverId?: number;
+}
+/** PII-safe requester/modifier projection. The ONLY shape of a Seerr user that may reach output. */
+export interface DomainUser {
+    displayName: string;
+    id: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/services/seerr/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/seerr/types.ts"],"names":[],"mappings":"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"}

package/dist/services/seerr/types.js

@@ -0,0 +1,11 @@
+/**
+ * @fileoverview Raw upstream Seerr API types (hand-written from the OpenAPI spec +
+ * live read-only probes against Seerr 3.3.0) and the normalized domain types this
+ * server exposes. Raw types default to optional unless the live payload guarantees
+ * presence — third-party APIs omit fields rather than nulling them, and over-strict
+ * raw types either fail validation or invent facts. The domain types are the
+ * PII-redacted projections produced by `normalizers.ts`.
+ * @module services/seerr/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/services/seerr/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/seerr/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/package.json

@@ -0,0 +1,86 @@
+{
+  "name": "@cyanheads/seerr-mcp-server",
+  "version": "0.1.0",
+  "description": "Search Jellyseerr/Overseerr, check availability, and create guarded media requests via MCP. STDIO or Streamable HTTP.",
+  "mcpName": "io.github.cyanheads/seerr-mcp-server",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "seerr-mcp-server": "dist/index.js"
+  },
+  "files": [
+    "changelog/",
+    "dist/",
+    "README.md",
+    "LICENSE",
+    "CLAUDE.md",
+    "AGENTS.md",
+    "Dockerfile",
+    "server.json"
+  ],
+  "scripts": {
+    "build": "bun run scripts/build.ts",
+    "rebuild": "bun run scripts/clean.ts && bun run scripts/build.ts",
+    "clean": "bun run scripts/clean.ts",
+    "devcheck": "bun run scripts/devcheck.ts",
+    "audit:refresh": "rm -f bun.lock && bun install && bun audit",
+    "tree": "bun run scripts/tree.ts",
+    "list-skills": "bun run scripts/list-skills.ts",
+    "format": "biome check --write .",
+    "format:unsafe": "biome check --write --unsafe .",
+    "lint:mcp": "bun run scripts/lint-mcp.ts",
+    "lint:packaging": "bun run scripts/lint-packaging.ts",
+    "bundle": "bun run build && npx -y @anthropic-ai/mcpb pack . dist/seerr-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/seerr-mcp-server.mcpb",
+    "changelog:build": "bun run scripts/build-changelog.ts",
+    "changelog:check": "bun run scripts/build-changelog.ts --check",
+    "release:github": "bun run scripts/release-github.ts",
+    "publish-mcp": "mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish",
+    "test": "vitest run",
+    "start": "node dist/index.js",
+    "start:stdio": "MCP_TRANSPORT_TYPE=stdio node dist/index.js",
+    "start:http": "MCP_TRANSPORT_TYPE=http node dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "jellyseerr",
+    "overseerr",
+    "seerr",
+    "radarr",
+    "sonarr",
+    "media-requests"
+  ],
+  "author": "cyanheads <casey@caseyjhand.com> (https://github.com/cyanheads/seerr-mcp-server#readme)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cyanheads/seerr-mcp-server.git"
+  },
+  "homepage": "https://github.com/cyanheads/seerr-mcp-server#readme",
+  "bugs": {
+    "url": "https://github.com/cyanheads/seerr-mcp-server/issues"
+  },
+  "license": "Apache-2.0",
+  "engines": {
+    "bun": ">=1.3.0",
+    "node": ">=24.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@cyanheads/mcp-ts-core": "^0.10.6",
+    "pino-pretty": "^13.1.3",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.5.0",
+    "@types/node": "25.9.3",
+    "depcheck": "^1.4.7",
+    "ignore": "^7.0.5",
+    "tsc-alias": "^1.8.17",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.8"
+  }
+}