scrypted-mcp-plugin

List installed Scrypted plugins. Returns for each: Scrypted device `id`, npm `pluginId` (the id passed to reload_plugin / get_plugin_info / kill_plugin), name, and type.

Inspect a plugin: pid, pending RPC calls, object count, etc.

Restart a plugin host process (preserves state, picks up code changes).

Kill a plugin host without auto-reload — the plugin stays down until you call reload_plugin or the server restarts. Prefer reload_plugin unless you specifically need it stopped.

Install (or upgrade) a plugin from npm. Returns the plugin device id.

Check all installed plugins against npm and upgrade any that are outdated.

Query npmjs.org via the Scrypted server. Pass a package name (e.g. "scrypted-kasa") for full metadata, or "-/v1/search?text=keywords:scrypted-plugin" to discover available Scrypted plugins. Returns the raw npm registry response.

Rename a Scrypted device id. Briefly kills the owning plugin host while it rewrites references — expect a short offline window.

Replace the list of mixins on a device. The provided array fully replaces the device's current mixins — read get_device first if you only want to add or remove one. Mixin ids are device ids of plugins like prebuffer, snapshot, REST, etc.

Read a plugin device's persistent KV storage (string keys, string values).

Replace a plugin device's persistent KV storage. The provided map fully replaces existing storage — read get_storage first if you only want to change one key.

Reverse-lookup a Scrypted device id from a plugin's internal nativeId. Useful when reading logs that reference nativeIds. Returns { id: null } if no match.

Disconnect all websocket clients of a plugin (forces reconnection).

Clear a plugin device's console buffer. Useful for setting up a clean repro window.

Fetch retained server-side logs (newest first). Filter by component (substring match), level, sinceMs. Results are capped (`truncated: true` when more matched) — narrow the filters or raise `limit` to see the rest.

Clear the server-side log buffer. Returns { cleared: true } on success.

List Scrypted alerts (newest first). Alerts are persisted notices like plugin crashes or warnings. Results are capped (`truncated: true` when more matched) — raise `limit` to see the rest.

Remove a single alert by id (use the `id` field from list_alerts).

Remove all alerts. Returns { cleared: true } on success.

List devices on the Scrypted server. Filter by interface, type, or name substring.

Get a snapshot of every state property on a device. Returns the full state map, which can be large for cameras; the `interfaces` array tells you which methods call_device_method can invoke.

Invoke a method on a device (e.g. turnOn, setBrightness, getSettings). The available methods follow from the device's `interfaces` — call get_device first if unsure. May read or mutate depending on the method. Returns the JSON-serialized result.

Get Scrypted server version and SCRYPTED_* environment variables.

Restart the Scrypted server. The current MCP connection will drop and need to reconnect.

Trigger a Scrypted server update. Honors SCRYPTED_WEBHOOK_UPDATE if set, otherwise writes .update and restarts. Returns immediately; the server restarts asynchronously and the MCP connection will drop, like restart_server.

Read the contents of the Scrypted .env file. Returns empty content if the file does not exist.

Overwrite the Scrypted .env file. The provided content is written verbatim — include all keys you want to keep.

List Scrypted user accounts (username + admin flag).

Create a new Scrypted user. Omit aclId to create an admin.

Delete a Scrypted user by username.

Get the configured local addresses / interface names that Scrypted advertises.

Replace the configured local addresses. Pass interface names ("en0") or IPs.

Get the configured external (publicly reachable) addresses for a plugin endpoint.

Replace the configured external addresses for a plugin endpoint.

Get the CORS origin allowlist for a plugin endpoint.

Replace the CORS origin allowlist for a plugin endpoint.

List registered Scrypted cluster worker nodes (id, name, labels, mode, address, fork count).

Snapshot the Scrypted database. Returns the ZIP inline as a base64-encoded resource (plus a JSON summary with byte count + sha256) for the agent to save locally. Nothing is written to the Scrypted host filesystem.