arr-mcp

Description is built at runtime.

Faults in Radarr, Sonarr and Whisparr quality profiles: a minimum custom format score nothing can reach, a score set exactly on the edge, a narrower language format scored while a wider one sits at zero, a scored language the minimum does not enforce, a dialect sibling left uncovered, and Profilarr-reported drift between its saved profiles and what an instance actually holds. Each profile is checked on its own, so a finding on some profiles says nothing about which others score the same format. Drift findings are instance-scoped, not tied to any one profile, and are unaffected by the `profile`…

Everything currently downloading or stalled, merged across Radarr, Sonarr, SABnzbd, Transmission and qBittorrent. Sizes are bytes and ETAs are seconds regardless of how each service reports them. Titles are release names from public indexers and are fenced as untrusted data. A Radarr or Sonarr row also carries `downloadId`, the download client's own id for that grab — pass it to `trigger_scan` with `action: "import"` when a finished download is sitting at `importState: "importBlocked"` and never got imported. Such a row also carries `statusMessages`, the service's own reasons, fenced: a title …

Description is built at runtime.

Media requests in Seerr — pending, approved or declined — for one user. Defaults to the configured user; reading another requires allow_other_users. At `detail: "full"` it also returns `issues`: what your users have reported as broken (video, audio, subtitle), each with its newest comments. Issues are everyone's, not just this user's, and a Seerr that cannot answer for them still answers for the requests.

Subtitles Bazarr knows are missing, for both films and episodes, with the languages wanted for each — and which subtitle providers are currently working, throttled, or blocked, which is usually why something is missing. Release names come from public indexers and are fenced as untrusted data.

`get_library` can say a movie is missing (`monitored` with no file), but not which episodes of a show are missing, and neither tool can say what already has a file but not yet the wanted quality. `get_wanted` answers both, from Radarr and Sonarr's own wanted lists. `scope: "missing"` is monitored items with no file; `scope: "upgradable"` is monitored items with a file below the quality profile's cutoff — both required, since a default would hide one. Sonarr rows carry `season`, `episode` and the episode's own `episodeTitle`, with `title` naming the show; Radarr rows are movies, and only ever s…

Tells Radarr or Sonarr to grab one specific release listed by get_releases — the "not that one, the 1080p remux" action. Takes `guid` and `indexer_id` from a get_releases result verbatim; together they identify the release and nothing else does. It also takes a `magnet` link instead, sent straight to transmission or qbittorrent — that path skips Radarr and Sonarr entirely, so nothing vets the release and nothing imports it into your library afterwards. Safe tier: the download can be removed again with remove_queue_item, so `safe_write` is enough. Slow to preview — it re-runs the interactive se…

Metadata for something you may not have: title, year, and external ids, from Radarr, Sonarr and Seerr. Query imdb:tt… to turn an IMDb id into a TMDB id; a bare tt… misses Seerr. Reads only — nothing is added, requested or monitored.

Adds, edits, disables, re-enables or deletes one Prowlarr indexer, then syncs Prowlarr to Radarr and Sonarr. `add` takes a `definition` name and only adds public indexers that need no login; anything private or semi-private is refused, because arr-mcp never handles indexer credentials. `edit` changes priority, app profile, tags and torrent seed settings, nothing else. `disable` stops every grab through that indexer in every app, whatever its sync level, and `enable` undoes it. All of those are safe tier. `delete` removes the indexer from Prowlarr and from each app Prowlarr syncs to, needs the …

Pauses, resumes or throttles one download client — SABnzbd, Transmission or qBittorrent — or pauses one item in its queue when `id` is given. The bandwidth answer: "stop downloading for an hour", or `action: "limit"` with `speed_limit_kbps` to slow it down instead of stopping it (0 removes the cap). A limit is always client-wide, never per item. Safe tier, because the undo is this same tool with the other action. It does NOT stop Radarr or Sonarr grabbing: they carry on finding and sending releases, which then sit in the paused client. `service` is required and names one client; pausing "every…

Removes one entry from Radarr or Sonarr's blocklist, so that release can be grabbed again. The fix for "this never downloads and I do not know why" once get_blocklist has said why. Take `service` and `id` from a get_blocklist row. Safe tier: the entry is a refusal to grab, and removing it only withdraws that refusal — nothing on disk changes, and the release can be blocklisted again through remove_queue_item's `blocklist` flag. Previews by default — call again with the returned `confirm` token to remove it.

Removes one item from a download queue — the stuck-at-0%, wrong-release, or stalled download. Works against Radarr, Sonarr, SABnzbd, Transmission and qBittorrent; take `service` and `id` from get_queue. Optionally deletes partial data and, on Radarr and Sonarr only, blocklists the release so it will not be grabbed again. Previews by default — call again with the returned `confirm` token to actually remove it.

Asks Seerr for a film or series, the way a household member would through its web UI — it enters the approval queue and counts against that user's quota. This is the tool for "request X". It is not add_media: add_media writes straight into Radarr or Sonarr, skipping approval and quota entirely, and needs that service's own write permission. `media_id` is a TMDB id — take one from search_media, lookup_media or discover_media (an IMDb tt… id is not one: look it up as imdb:tt… to get its TMDB id); Seerr resolves the TVDB id itself. For a series, `seasons` defaults to every season. `user` names wh…

Approves or declines a pending Seerr request. Approving hands it to Radarr or Sonarr, which will search for it and download it — so it costs disk space and bandwidth even though the decision itself is reversible. Take `id` from get_requests. Previews by default — call again with the returned `confirm` token to actually apply the verdict.

Search across the stack: your existing library, metadata for things you do not have yet, or what indexers currently offer. Indexer results contain attacker-controllable release names and are returned inside an explicit untrusted-data boundary.

Turns Sonarr monitoring on or off for a whole series, one season, or specific episodes. Safe tier — nothing is deleted and Sonarr can undo it, so `safe_write` is enough. Give `season` for one season, `episodes` for specific episode ids, or neither for the whole series; giving both is refused rather than resolved. Unmonitoring **before** deleting files is what stops Sonarr immediately re-downloading them — see delete_episode_files. Takes `service` and `id`, never a title: take `id` from `acquisition.id` on a get_library or get_media_details record. Previews by default — call again with the retu…

Description is built at runtime.

Health of every configured service: version, disk space, failing health checks, when each library was last scanned, and what each instance is permitted to do. Returns partial results with a `degraded` list rather than failing when a service is down. `commands` is how you follow up a `trigger_search` or `trigger_scan`: it lists the searches, scans, refreshes, renames and imports each service has queued or running, plus any it finished in the last fifteen minutes — so a command that is not there has finished. A service's own per-minute housekeeping is left out. The `permissions` list is also the…

Asks Profilarr to pull one of its databases — custom formats, quality profiles, delay profiles — from its configured git source. Safe tier: it only changes Profilarr's own store, never Radarr or Sonarr directly. `database` names one by name or id; required only when Profilarr has more than one. Profilarr answers the request with a queued job, and this tool polls it to a terminal status before reporting anything, so the result reflects whether the sync actually finished, not just that it was accepted. A sync can legitimately find nothing to pull; that reports as a completed call whose `outcome`…

Asks a service to reconcile itself with what is on disk — the "it downloaded but still will not play" family of actions, and the usual fix for what `diagnose` reports as a stale scan. With no `id`, it rescans the whole library of Radarr, Sonarr, Jellyfin or Plex; the media server is the one that matters when something is missing from what you can actually watch. On Prowlarr there is no library, and this pushes its indexer list to Radarr and Sonarr instead — the fix for "the app is using an indexer Prowlarr no longer has". With an `id`, it rescans just that Radarr/Sonarr item, which is far chea…

Asks Radarr, Sonarr or Whisparr to go looking for releases for one item it already tracks — the "it never downloaded, try again" action. Takes `service` and `id`, deliberately not a title: take `id` from `acquisition.id` on a get_library or get_media_details record. On Sonarr or Whisparr, give `season` to search one season or `episodes` for specific episode ids; giving both is refused rather than resolved, and neither on Radarr, which has no seasons. This queues a search and returns immediately; it does not wait for a release to be found, and finding one is not guaranteed. Previews by default …

Asks Bazarr to go looking for one language of subtitles for one item it already tracks — the "it is missing Dutch subs and I do not want to wait for the next round" action. Takes `kind`, `id` and `language` exactly as get_subtitles reports them. By default it only searches for something Bazarr lists as missing; `search_anyway: true` searches regardless, which is how you replace a subtitle you already have but do not want (for an episode outside that list, pass `series_id` too). This queues a search and returns immediately; it does not wait, and finding a subtitle is not guaranteed. Previews by…

Changes settings on something already in Radarr or Sonarr: quality profile, root folder, monitoring, tags, Radarr’s minimum availability, Sonarr’s series type. The counterpart to add_media, which only ever adds — and the only way to change a **Radarr** item’s monitoring, since set_monitoring is Sonarr’s per-season tool. Takes `service` and `id`, never a title: take `id` from `acquisition.id` on a get_library or get_media_details record. Changing `root_folder` asks the service to **move the files on disk**; pass `move_files: false` to leave them where they are, which reports them missing until …