/moviepilot-api

name: moviepilot-api
version: 73
description: >-
  Use this skill for MoviePilot product operations such as media search, torrent
  search, downloads, subscriptions, library checks, sites, storage, workflows,
  schedulers, plugins, filter rules, and system settings. It authorizes the
  structured moviepilot_api gateway only; it does not authorize arbitrary HTTP,
  legacy Agent tools, MCP compatibility commands, authentication headers, or API
  tokens.
allowed-tools: moviepilot_api
allowed-api-operations: >-
  media.search media.person.search media.person.credits media.recognize media.scrape
  media.episode_schedule media.detail subscription.add subscription.update subscription.search
  subscription.list subscription.shares subscription.popular subscription.history
  subscription.delete download.add download.artist_collection download.tasks.active
  download.clients download.paths download.history.list download.history.delete
  transfer.history.delete site.update site.list site.userdata site.test site.cookie.update
  recommendation.list library.exists library.latest storage.settings storage.list transfer.history
  transfer.history.register transfer.file scheduler.list scheduler.run workflow.list workflow.run
  plugin.installed plugin.market plugin.capabilities plugin.config.get plugin.config.update
  plugin.source.options plugin.source.install plugin.source.change plugin.reload plugin.install
  plugin.uninstall slash.list config.identifiers.get config.identifiers.update search.torrents
  search.results filter.builtin filter.custom filter.groups filter.custom.add filter.custom.update
  filter.custom.delete filter.group.add filter.group.update filter.group.delete plugin.data
  config.system.list config.system.describe config.system.get config.system.update slash.run
  music.recognize music.explore music.album.get music.album.related music.artist.get
  music.artist.albums music.artist.related music.cache.get music.cache.delete music.cache.clear
  system.versions system.update.status system.update.check system.update.download system.restart
  system.update.install system.upgrade.dev dashboard.media.statistics dashboard.storage
  dashboard.processes dashboard.system dashboard.downloader scheduler.progress
  dashboard.transfer.statistics dashboard.cpu dashboard.memory dashboard.network media.sources
  media.recognize_file media.cache.get media.cache.delete media.cache.clear
  media.classification.fields media.classification.policy.get media.classification.policy.validate
  media.classification.policy.preview media.classification.policy.impact
  media.classification.policy.history media.classification.policy.update
  media.classification.policy.rollback media.episode_groups media.episode_group.seasons
  media.seasons search.title search.recommend subtitle.search.title subtitle.search.media site.add
  site.delete site.auth.options site.authenticate site.cookiecloud.sync site.cookie.set site.reset
  site.priorities.update site.userdata.refresh site.userdata.latest site.category site.resource
  site.searchable site.rss site.statistics site.statistic site.mapping site.supporting
  subscription.get subscription.find subscription.delete_by_media subscription.status.update
  subscription.reset subscription.search_all subscription.refresh subscription.metadata.refresh
  subscription.history.delete subscription.user.list subscription.files
  subscription.execution.list subscription.execution.get subscription.execution.cancel
  subscription.share subscription.share.delete subscription.fork subscription.follow.list
  subscription.follow.add subscription.follow.delete subscription.share.statistics storage.manage
  storage.mkdir storage.rename storage.delete transfer.queue transfer.queue.delete transfer.name
  transfer.target_path transfer.manual_history transfer.episode_format.recommend
  transfer.manual_reviews transfer.manual_review transfer.manual_review.resolve
  transfer.history.redo transfer.history.redo_batch transfer.history.replan transfer.history.clear
  workflow.create workflow.get workflow.update workflow.delete workflow.actions
  workflow.event_types workflow.plugin.actions workflow.start workflow.pause workflow.reset
  workflow.shares workflow.share workflow.share.delete workflow.fork torrent.cache.get
  torrent.cache.delete torrent.cache.clear torrent.cache.refresh torrent.cache.reidentify
  database.backups.list database.backups.create database.backups.verify database.backups.delete
  filter.test system.network.targets system.network.test system.module.list system.module.catalog
  system.module.settings system.module.test plugin.market.sync_wiki plugin.runtime.status
  plugin.history plugin.releases plugin.ratings plugin.rating plugin.rating.submit
  plugin.statistics plugin.reset plugin.clone.restorable plugin.clone config.user.get
  config.public.get system.usage.statistics plugin.folders.get plugin.folders.update
  plugin.folder.create plugin.folder.update plugin.folder.delete plugin.folder.plugins.update
  plugin.folder.plugin.assign plugin.folder.plugin.remove plugin.loglevel.get plugin.loglevel.set
  plugin.loglevel.clear plugin.default_target.set plugin.default_target.clear
  plugin.instance.set_enabled plugin.instance.purge

MoviePilot API

When a plugin mutation is busy or its outcome is unknown, inspect `plugin.runtime.status` before retrying. `active_operation` identifies the running plugin, operation, hook, and elapsed time. A caller timeout or cancellation does not stop the hook and must never trigger automatic replay of the same mutation.

`plugin.config.update` replaces the complete configuration. Preserve every field not intentionally removed. The gateway rejects an empty object or redacted credential placeholders such as `***`; do not guess their original values. If the available configuration contains placeholders, use the plugin configuration UI.

For a historical invalid plugin instance ID reported in logs, `plugin.instance.purge` accepts the exact ID with only