nuvio-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| NUVIO_EMAIL | No | Nuvio account email | |
| NUVIO_PASSWORD | No | Nuvio account password | |
| NUVIO_HTTP_HOST | No | Host for the HTTP endpoint (used with NUVIO_TRANSPORT=http) | |
| NUVIO_HTTP_PORT | No | Port for the HTTP endpoint (used with NUVIO_TRANSPORT=http) | |
| NUVIO_TRANSPORT | No | Transport mode: stdio (default) or http | |
| NUVIO_HTTP_TOKEN | No | Bearer token for the HTTP endpoint | |
| NUVIO_REFRESH_TOKEN | No | Alternative to email/password | |
| NUVIO_DISABLE_SNAPSHOTS | No | Set to 'true' to disable local snapshots |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| nuvio_list_profilesA | List all profiles (index 1..6, name, avatar, flags, PIN lock state). |
| nuvio_create_profileA | Add a new profile, preserving every existing one. Max 6 profiles; profile 1 is primary. The previous state is snapshotted before the write; revert with nuvio_undo. |
| nuvio_update_profileA | Sparsely update one profile (name, avatar color, avatar id/url, uses_primary_addons). The previous state is snapshotted before the write; revert with nuvio_undo. |
| nuvio_delete_profileA | Delete a profile and ALL of its data (addons, settings, collections, library, history). Profile 1 cannot be deleted and this cannot be undone. This operation cannot be undone: it uses two-phase confirmation — call it once to get a short-lived confirmation token, then call again with that token to execute. |
| nuvio_copy_profile_setupA | Copy TV/mobile/desktop settings (and optionally provider credentials) from one profile to another. The previous state is snapshotted before the write; revert with nuvio_undo. |
| nuvio_set_profile_pinA | Set or change the PIN lock on a profile. Not reversible (the PIN hash is never returned). This operation cannot be undone: it uses two-phase confirmation — call it once to get a short-lived confirmation token, then call again with that token to execute. |
| nuvio_clear_profile_pinA | Remove the PIN lock from a profile. Not reversible. This operation cannot be undone: it uses two-phase confirmation — call it once to get a short-lived confirmation token, then call again with that token to execute. |
| nuvio_list_addonsA | List the addons installed on a profile (url, name, enabled, sort_order). |
| nuvio_inspect_addonA | Fetch and summarise a Stremio/Nuvio addon manifest (name, version, resources, catalog types) before installing. |
| nuvio_add_addonA | Install an addon on a profile by manifest URL. The current addon list is read and preserved; only the new addon is appended. The previous state is snapshotted before the write; revert with nuvio_undo. |
| nuvio_update_addonA | Change an addon name, enabled flag or sort order. Identify it by url or table id. The previous state is snapshotted before the write; revert with nuvio_undo. |
| nuvio_toggle_addonA | Turn one addon on or off for a profile. The previous state is snapshotted before the write; revert with nuvio_undo. |
| nuvio_reorder_addonsA | Set the display order of a profile's addons. Provide every installed addon URL exactly once, in the desired order. The previous state is snapshotted before the write; revert with nuvio_undo. |
| nuvio_remove_addonA | Uninstall one addon from a profile. The previous state is snapshotted before the write; revert with nuvio_undo. |
| nuvio_list_pluginsA | List plugins installed on a profile. |
| nuvio_add_pluginA | Install a plugin on a profile by URL, preserving the existing plugin list. The previous state is snapshotted before the write; revert with nuvio_undo. |
| nuvio_toggle_pluginA | Turn one plugin on or off for a profile. The previous state is snapshotted before the write; revert with nuvio_undo. |
| nuvio_reorder_pluginsA | Set plugin order. Provide every installed plugin URL exactly once, in the desired order. The previous state is snapshotted before the write; revert with nuvio_undo. |
| nuvio_remove_pluginA | Uninstall a plugin from a profile. The previous state is snapshotted before the write; revert with nuvio_undo. |
| nuvio_get_settingsA | Read the JSON settings blob for a profile on a platform. |
| nuvio_update_settingsA | Shallow-merge top-level keys into a profile's settings blob. For nested keys use nuvio_set_setting. The previous state is snapshotted before the write; revert with nuvio_undo. |
| nuvio_set_settingA | Set one nested value by dot path (e.g. 'features.player_settings.auto_play_next' or 'rows.0.height'). Creates intermediate objects/arrays as needed. The previous state is snapshotted before the write; revert with nuvio_undo. |
| nuvio_unset_settingA | Delete one nested value by dot path from the settings blob. The previous state is snapshotted before the write; revert with nuvio_undo. |
| nuvio_copy_settingsA | Replace the target's settings blob with a copy of the source's. Works across profiles and platforms (e.g. tv -> mobile). The previous state is snapshotted before the write; revert with nuvio_undo. |
| nuvio_get_home_catalog_settingsB | Read the home screen layout/catalog configuration for a profile on a platform. |
| nuvio_update_home_catalog_settingsA | Shallow-merge keys (e.g. rows, hidden_catalogs) into the home catalog settings blob. The previous state is snapshotted before the write; revert with nuvio_undo. |
| nuvio_set_home_catalog_pathA | Set one nested value by dot path inside the home catalog settings blob. The previous state is snapshotted before the write; revert with nuvio_undo. |
| nuvio_list_collectionsA | List a profile's custom collections (titles, view mode, folders, catalog sources). |
| nuvio_create_collectionA | Add a new collection to a profile. The previous state is snapshotted before the write; revert with nuvio_undo. |
| nuvio_update_collectionA | Edit a collection's title, view mode, pin state or replace its folder list. The previous state is snapshotted before the write; revert with nuvio_undo. |
| nuvio_delete_collectionA | Remove a collection from a profile. The previous state is snapshotted before the write; revert with nuvio_undo. |
| nuvio_add_collection_folderA | Append a folder (with catalog sources) to an existing collection. The previous state is snapshotted before the write; revert with nuvio_undo. |
| nuvio_update_collection_folderA | Edit a folder's title, cover, tile shape or catalog sources. The previous state is snapshotted before the write; revert with nuvio_undo. |
| nuvio_remove_collection_folderA | Remove a folder from a collection. The previous state is snapshotted before the write; revert with nuvio_undo. |
| nuvio_reorder_collectionsA | Set collection order. Provide every collection id exactly once, in the desired order. The previous state is snapshotted before the write; revert with nuvio_undo. |
| nuvio_duplicate_collectionA | Copy a collection (including folders and catalog sources) under a new id, placed right after the source. The previous state is snapshotted before the write; revert with nuvio_undo. |
| nuvio_reorder_collection_foldersA | Set folder order. Provide every folder id in the collection exactly once, in the desired order. The previous state is snapshotted before the write; revert with nuvio_undo. |
| nuvio_get_libraryA | List items in a profile's library (bookmarks/favourites). |
| nuvio_add_to_libraryA | Add or update an item in a profile's library. The previous state is snapshotted before the write; revert with nuvio_undo. |
| nuvio_remove_from_libraryA | Remove items from a profile's library by content_id + content_type. The previous state is snapshotted before the write; revert with nuvio_undo. |
| nuvio_get_watch_progressA | List "continue watching" progress entries for a profile. |
| nuvio_set_watch_progressA | Create or update a continue-watching entry (position/duration) for a movie or episode. The previous state is snapshotted before the write; revert with nuvio_undo. |
| nuvio_delete_watch_progressA | Delete continue-watching entries by progress key. The previous state is snapshotted before the write; revert with nuvio_undo. |
| nuvio_get_watch_historyC | List watched items for a profile. |
| nuvio_mark_watchedA | Add an entry to a profile's watch history. The previous state is snapshotted before the write; revert with nuvio_undo. |
| nuvio_delete_watch_historyA | Delete watch-history entries by content id (and season/episode). The previous state is snapshotted before the write; revert with nuvio_undo. |
| nuvio_list_provider_credentialsA | List configured providers for a profile (debrid services, TMDB, MDBList, AniSkip, IntroDB). Secret values are masked. |
| nuvio_set_provider_credentialA | Store an API key for a provider: debrid:torbox, debrid:premiumize, debrid:realdebrid, tmdb, mdblist, introdb (api key) or animeskip (client id). The previous state is snapshotted before the write; revert with nuvio_undo. |
| nuvio_delete_provider_credentialA | Remove a stored provider credential from a profile. The previous state is snapshotted before the write; revert with nuvio_undo. |
| nuvio_list_trackersA | List linked trackers (MAL / AniList / Kitsu) and their per-profile settings. Access tokens are masked. |
| nuvio_set_tracker_settingsA | Set which statuses sync, row order and progress syncing for a linked tracker. The previous state is snapshotted before the write; revert with nuvio_undo. |
| nuvio_link_trackerA | Store tracker OAuth tokens for a profile. Use this only when tokens were obtained out-of-band; prefer the app sign-in flow. The previous state is snapshotted before the write; revert with nuvio_undo. |
| nuvio_unlink_trackerA | Remove stored tokens for a tracker on a profile. The previous state is snapshotted before the write; revert with nuvio_undo. |
| nuvio_list_sessionsA | List active login sessions/devices (device name, platform, client, last active, which is current). |
| nuvio_revoke_sessionA | Revoke one login session (log that device out). Cannot be undone — the device must sign in again. Never deletes the account. This operation cannot be undone: it uses two-phase confirmation — call it once to get a short-lived confirmation token, then call again with that token to execute. |
| nuvio_register_deviceA | 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. This operation cannot be undone: it uses two-phase confirmation — call it once to get a short-lived confirmation token, then call again with that token to execute. |
| nuvio_whoamiA | Return the signed-in Nuvio account and the backend URL. |
| nuvio_sync_overviewA | Summary counts of profiles, addons, plugins, library items, watch progress and history. |
| nuvio_list_avatarsA | List avatar catalog ids available for profile avatars. |
| nuvio_healthA | Ping the Nuvio backend database. |
| nuvio_export_backupA | Export account data as a JSON backup (profiles, addons, plugins, library, progress, history, settings, collections). Credentials and tokens are excluded server-side. |
| nuvio_restore_backupA | 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. This operation cannot be undone: it uses two-phase confirmation — call it once to get a short-lived confirmation token, then call again with that token to execute. |
| nuvio_list_undoA | List recent automatically-captured snapshots. Each can be reverted with nuvio_undo. |
| nuvio_inspect_snapshotA | Show the captured previous state of a snapshot (secrets masked). |
| nuvio_undoA | Revert a previous change using its snapshot. Defaults to the most recent change. Snapshots the current state first, so an undo can itself be undone. |
| nuvio_redoA | Re-apply the change that the most recent nuvio_undo reverted. Snapshots current state first. |
| nuvio_capabilitiesA | Describe this Nuvio MCP server: backend, transport, automatic-undo behaviour, and the full tool list. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 67 tools
Each tool targets a specific resource/action and most are clearly distinct (profiles, addons, plugins, collections, etc.). A few pairs could be confused from names alone — e.g. nuvio_update_collection vs nuvio_update_collection_folder, nuvio_set_setting vs nuvio_set_home_catalog_path, or nuvio_copy_settings vs nuvio_copy_profile_setup — but the descriptions resolve the boundaries.
All names follow the nuvio_<verb>_<object> snake_case pattern and are predictable. Minor inconsistencies exist: list vs get, add vs create, remove vs delete, plus a few noun-only names (nuvio_whoami, nuvio_health, nuvio_capabilities, nuvio_undo/redo).
67 tools is far beyond the well-scoped range and will likely overwhelm agent tool selection, even though the domain is broad. The tools are individually meaningful, but the surface is much heavier than typical MCP servers and could benefit from consolidation or sub-grouping.
The set provides full lifecycle coverage for profiles, addons, plugins, settings, collections, library, watch progress/history, provider credentials, trackers, and sessions, plus backup/restore and undo/redo. No obvious dead ends or missing core operations were found.