plex_delete_media

Permanently delete a movie or episode from the Plex library by its ratingKey. Get the ratingKey from plex_search.

Server Homelab nainounen/homelab-mcp
Category Destructive
Risk class Critical
Parameters 00 required

What plex_delete_media does on Homelab

AI agents call plex_delete_media to permanently remove resources in Homelab — typically in cleanup and lifecycle workflows. It does its job in a single call, and there is no undo.

Why plex_delete_media needs a policy

This tool irreversibly removes media content from a Plex library. Once deleted, the data cannot be recovered through normal means. This is a destructive operation that cannot be undone, making it a Destructive category risk. Severity is high because an AI agent with misaligned goals could systematically delete a user's entire media library, causing significant loss of content and personal media collection value.

From the tool's definition Tool name explicitly states 'delete' and description confirms 'Permanently delete a movie or episode from the Plex library'. The term 'permanently' indicates irreversible data loss.

Questions about plex_delete_media

What does the plex_delete_media tool do? +

Permanently delete a movie or episode from the Plex library by its ratingKey. Get the ratingKey from plex_search. It is categorised as a Destructive tool in the Homelab MCP Server, which means it can permanently delete or destroy data. Block by default and require explicit approval.

How do I enforce a policy on plex_delete_media? +

Register the Homelab MCP server in PolicyLayer and add a rule for plex_delete_media: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches Homelab. Nothing to install.

What risk level is plex_delete_media? +

plex_delete_media is a Destructive tool with critical risk. Critical-risk tools should be blocked by default and only enabled with explicit human approval.

Can I rate-limit plex_delete_media? +

Yes. Add a rate_limit block to the plex_delete_media rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.

How do I block plex_delete_media completely? +

Set action: deny in the PolicyLayer policy for plex_delete_media. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.

What MCP server provides plex_delete_media? +

plex_delete_media is provided by the Homelab MCP server (nainounen/homelab-mcp). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.

// LOOK UP ANOTHER SERVER

Every MCP server has a record like this.

Type a name, get the same breakdown: verified identity, auth posture, risk grade, capabilities, recommended policy.

Teams ship this data inside their own products. See what a licence covers →

// GET IN TOUCH

Have a question or want to learn more? Send us a message.

Message sent.

We'll get back to you soon.