io.github.cyanheads/seerr-mcp-server

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.

List recent media requests with their lifecycle status. Filter by status, media type, and requester; echoes the applied filters and decodes every numeric status. Pass a requestId from the results to seerr_request_status for full detail. Titles are not on request objects — set includeTitles to resolve them, or fetch one with seerr_get_media.

Fetch exact movie or show details by TMDB ID and media type to confirm the right title before any write. Returns availability and any existing open request. For TV, omit seasonNumber for a per-season summary, or pass a seasonNumber to fetch that season's episode list. Get the tmdbId from seerr_search_media first.

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.

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.

Create a Seerr media request — the guarded write. Defaults to mode:preview, which resolves the exact title and returns the request payload that WOULD be submitted WITHOUT creating anything; pass mode:request to actually submit, which asks for an explicit confirmation and submits only once that confirmation comes back accepted. Treat "download X" as "create a Seerr request for X". Always preview first unless the title is already confirmed.