MoviePilot MCP Server

MoviePilot MCP Server

The MoviePilot MCP server bridges the gap between a large language model and the MoviePilot media‑library automation platform. By exposing MoviePilot’s RESTful API as MCP tools, it lets conversational AI agents perform complex media‑management tasks—searching for titles, retrieving detailed metadata, managing subscriptions, and controlling download queues—all through natural language prompts. This eliminates the need for manual web‑interface interactions or custom scripting, enabling developers to build richer, voice‑oriented media workflows.

Key capabilities include:

• Media discovery – Search movies, TV shows, or personalities across TMDB and Douban; retrieve upcoming releases or newly aired series.
• Detail retrieval – Pull full metadata, episode lists, and season information for any title, making it easy to present comprehensive summaries in chat.
• Subscription management – Add, list, update, or delete automatic download subscriptions, including fine‑grained filtering of quality and subtitle options.
• Download control – Create new download tasks, monitor progress, pause or resume, and delete completed items.
• Library status – Query recently added media, currently playing items, or perform existence checks to keep the local catalog up to date.

These tools are packaged as standard MCP actions, so any client that implements the Model Context Protocol—such as Cherry Studio or a custom CLI—can invoke them with simple tool calls. A developer can, for example, ask the assistant to “subscribe me to the next season of Stranger Things and download it in 1080p with Chinese subtitles,” and the assistant will translate that into a series of MCP tool calls that interact directly with MoviePilot. This tight integration streamlines media workflow automation, reduces context switching for users, and opens the door to advanced scenarios like voice‑controlled media libraries or AI‑driven recommendation engines that act on real‑time data from MoviePilot.