List all profiles (slot 1..6, name, avatar, flags, PIN lock state).

Add a new profile, preserving every existing one. Max 6 profiles; slot 1 is primary. Supports dry_run and snapshots the previous state before the write; revert with nuvio_undo.

Sparsely update one profile (name, avatar color, avatar id/url, uses_primary_addons). Supports dry_run and snapshots the previous state before the write; revert with nuvio_undo.

Delete a profile and ALL of its data (addons, settings, collections, library, history). Profile 1 cannot be deleted and this cannot be undone. Cannot be undone: call it once to get a short-lived confirmation token, then call again with that token. Supports dry_run.

Copy a profile setup to another profile, optionally across platforms (platforms: [{from,to}], defaults to identity per platform). Settings are deep-merged (settings_mode=merge) or replaced (replace); provider credentials can be left alone, merged, or replaced. Transactional: on failure it rolls back and reports whether the rollback completed. Supports dry_run and snapshots the previous state before the write; revert with nuvio_undo.

Set or change the PIN lock on a profile. Not reversible (the PIN hash is never returned). Cannot be undone: call it once to get a short-lived confirmation token, then call again with that token. Supports dry_run.

Remove the PIN lock from a profile. Not reversible. Cannot be undone: call it once to get a short-lived confirmation token, then call again with that token. Supports dry_run.

[DEPRECATED] Use nuvio_copy_setup instead. Copy TV/mobile/desktop settings (and optionally provider credentials) from one profile to another. Supports dry_run and snapshots the previous state before the write; revert with nuvio_undo.

List the addons installed on a profile (url, name, enabled, sort_order).

Fetch and summarise a Stremio/Nuvio addon manifest (name, version, resources, catalog types) before installing.

Install an addon on a profile by manifest URL. The current addon list is read and preserved; only the new addon is appended. Supports dry_run and snapshots the previous state before the write; revert with nuvio_undo.

Change an addon name, enabled flag or sort order. Identify it by url or table id. Supports dry_run and snapshots the previous state before the write; revert with nuvio_undo.

Set the display order of a profile's addons. Provide every installed addon URL exactly once, in the desired order. Supports dry_run and snapshots the previous state before the write; revert with nuvio_undo.

Uninstall one addon from a profile. Supports dry_run and snapshots the previous state before the write; revert with nuvio_undo.

[DEPRECATED] Use nuvio_update_addon instead. Turn one addon on or off for a profile. Supports dry_run and snapshots the previous state before the write; revert with nuvio_undo.

List plugins installed on a profile.

Install a plugin on a profile by URL, preserving the existing plugin list. Supports dry_run and snapshots the previous state before the write; revert with nuvio_undo.

Change a plugin name, enabled flag, repo type or sort order. Identify it by url or table id. Supports dry_run and snapshots the previous state before the write; revert with nuvio_undo.

Set plugin order. Provide every installed plugin URL exactly once, in the desired order. Supports dry_run and snapshots the previous state before the write; revert with nuvio_undo.

Uninstall a plugin from a profile. Supports dry_run and snapshots the previous state before the write; revert with nuvio_undo.

[DEPRECATED] Use nuvio_update_plugin instead. Turn one plugin on or off for a profile. Supports dry_run and snapshots the previous state before the write; revert with nuvio_undo.

Read the JSON settings blob for a profile on a platform.

Update a profile settings blob. patch is deep-merged (nested keys are preserved, arrays and scalars replace), set assigns nested dot paths and unset deletes them — applied in the order patch, set, unset. This is the canonical replacement for nuvio_set_setting / nuvio_unset_setting. Supports dry_run and snapshots the previous state before the write; revert with nuvio_undo.

Update the home screen layout/catalog blob with the same patch/set/unset semantics as nuvio_update_settings. Supports dry_run and snapshots the previous state before the write; revert with nuvio_undo.

Read the home screen layout/catalog configuration for a profile on a platform.

[DEPRECATED] Use nuvio_update_settings instead. Set one nested value by dot path. Supports dry_run and snapshots the previous state before the write; revert with nuvio_undo.

[DEPRECATED] Use nuvio_update_settings instead. Delete one nested value by dot path. Supports dry_run and snapshots the previous state before the write; revert with nuvio_undo.

[DEPRECATED] Use nuvio_update_home_catalog_settings instead. Set one nested value by dot path inside the home catalog settings blob. Supports dry_run and snapshots the previous state before the write; revert with nuvio_undo.

[DEPRECATED] Use nuvio_copy_setup instead. Replace the target's settings blob with a copy of the source's. Supports dry_run and snapshots the previous state before the write; revert with nuvio_undo.

List a profile's custom collections (titles, view mode, folders, catalog sources).

Add a new collection to a profile. Supports dry_run and snapshots the previous state before the write; revert with nuvio_undo.

Edit a collection's title, view mode, pin state or replace its folder list. Supports dry_run and snapshots the previous state before the write; revert with nuvio_undo.

Remove a collection from a profile. Supports dry_run and snapshots the previous state before the write; revert with nuvio_undo.

Append a folder (with catalog sources) to an existing collection. Supports dry_run and snapshots the previous state before the write; revert with nuvio_undo.

Edit a folder's title, cover, tile shape or catalog sources. Supports dry_run and snapshots the previous state before the write; revert with nuvio_undo.

Remove a folder from a collection. Supports dry_run and snapshots the previous state before the write; revert with nuvio_undo.

Set collection order. Provide every collection id exactly once, in the desired order. Supports dry_run and snapshots the previous state before the write; revert with nuvio_undo.

Copy a collection (including folders and catalog sources) under a new id, placed right after the source. Supports dry_run and snapshots the previous state before the write; revert with nuvio_undo.

Set folder order. Provide every folder id in the collection exactly once, in the desired order. Supports dry_run and snapshots the previous state before the write; revert with nuvio_undo.

List items in a profile's library (bookmarks/favourites).

Add or update library items in bulk (upsert by content_id + content_type). Supports dry_run and snapshots the previous state before the write; revert with nuvio_undo.

Remove items from a profile's library by content_id + content_type. Supports dry_run and snapshots the previous state before the write; revert with nuvio_undo.

List "continue watching" progress entries for a profile.

Create or update continue-watching entries (position/duration) for movies or episodes, in bulk. Supports dry_run and snapshots the previous state before the write; revert with nuvio_undo.

Delete continue-watching entries using structured keys (content_id + optional season/episode). Supports dry_run and snapshots the previous state before the write; revert with nuvio_undo.

List watched items for a profile.

Idempotently add watched items to a profile's history (upsert by content_id + season + episode). A repeated identical call does not create a duplicate. Supports dry_run and snapshots the previous state before the write; revert with nuvio_undo.

Delete watch-history entries by content id (and season/episode). Supports dry_run and snapshots the previous state before the write; revert with nuvio_undo.

[DEPRECATED] Use nuvio_add_to_watch_history instead. Add an entry to a profile's watch history. Supports dry_run and snapshots the previous state before the write; revert with nuvio_undo.

List configured providers for a profile (debrid services, TMDB, MDBList, AniSkip, IntroDB). Secret values are masked.

Store an API key for a provider: debrid:torbox, debrid:premiumize, debrid:realdebrid, tmdb, mdblist, introdb (api key) or animeskip (client id). Supports dry_run and snapshots the previous state before the write; revert with nuvio_undo.

Verify a provider credential without storing it. The secret is never returned or logged; the result reports format validity and, where the provider exposes a cheap endpoint, a live check.

Remove a stored provider credential from a profile. Supports dry_run and snapshots the previous state before the write; revert with nuvio_undo.

List linked trackers (MAL / AniList / Kitsu) and their per-profile settings. Access tokens are masked.

Set which statuses sync, row order and progress syncing for a linked tracker. Supports dry_run and snapshots the previous state before the write; revert with nuvio_undo.

Store tracker OAuth tokens for a profile. Use this only when tokens were obtained out-of-band; prefer the app sign-in flow. Supports dry_run and snapshots the previous state before the write; revert with nuvio_undo.

Remove stored tokens for a tracker on a profile. Supports dry_run and snapshots the previous state before the write; revert with nuvio_undo.

List active login sessions/devices (device name, platform, client, last active, which is current).

Revoke one login session (log that device out). Cannot be undone — the device must sign in again. Never deletes the account. Cannot be undone: call it once to get a short-lived confirmation token, then call again with that token. Supports dry_run.

Register a device/installation against the account. client_name must be one the Nuvio backend accepts (for example 'Nuvio Web'); other values are rejected by the backend. Cannot be undone: call it once to get a short-lived confirmation token, then call again with that token. Supports dry_run.

Return the signed-in Nuvio account and the backend URL.

Summary counts of profiles, addons, plugins, library items, watch progress and history.

List avatar catalog ids available for profile avatars.

Ping the Nuvio backend database.

Export account data as a JSON backup (profiles, addons, plugins, library, progress, history, settings, collections). Credentials and tokens are excluded server-side. With no scope this is a full backup; pass scope/profile_ids/platforms to narrow it.

Replace account data from a backup produced by nuvio_export_backup. Only available on self-hosted backends that expose sync_restore_account_backup. High risk: overwrites profiles/addons/library/settings. Cannot be undone: call it once to get a short-lived confirmation token, then call again with that token. Supports dry_run.

List recent automatically-captured snapshots. Each can be reverted with nuvio_undo.

Show the captured previous state of a snapshot (secrets masked).

Revert a previous change using its snapshot (single or composite). Defaults to the most recent change. Snapshots the current state first, so an undo can itself be undone.

Re-apply the change that the most recent nuvio_undo reverted. Snapshots current state first.

Delete old snapshot files according to retention limits (age, count, total size). Local-only; defaults to dry_run. Destructive local operation: previews unless confirm=true; dry_run=true always previews.

Apply several canonical operations as one transaction with a composite snapshot and rollback. Defaults to dry_run.

Describe this Nuvio MCP server: backend, transport, automatic-undo behaviour, the canonical tool list and the deprecated compatibility aliases.