<aside> ✅

Status: Published Last verified: 2026-07-23 — plex_whoami, catalog PROBE notes, server.py write gate

</aside>

Purpose

What plex-mcp is and is not; scope for Grace / Datum.

Verified

• MCP for Plex Smart Manufacturing (Rockwell ERP/MES) — not Plex Media Server
• REST on https://connect.plex.com; tenant 58f781ba-1691-4f32-b1db-381cdb21300c (1 tenant, live canary ok)
• Read-only by default (allow_writes=false); non-GET blocked unless PLEX_ALLOW_WRITES and confirm=True
• Catalog has 54 entries; 7 tagged PROBE
• A 404 RESOURCE_NOT_FOUND means no route matched that exact path — not proof of “unsubscribed.” Prefer 405 (route exists) / 403 ACCESS_DENIED (entitlement) for diagnosis. Do not copy the project-home “not subscribed (404)” wording.

Verified — parts masters (live 2026-07-23)

• Two intentional masters, same row count (42642) unfiltered:
  • /mdm/v1/parts — rich (~17 fields: name, group, productType, …)
  • /inventory/v1/inventory-definitions/parts — lean (8 fields; use for container partId joins)
• ?status=Active works only on MDM → 17206 rows; inv-defs ignores the filter
• Cache plex.parts = MDM mirror (for uniqueness / minting checks)

Unverified / Needs re-verify

• Classic SOAP still out of scope (stated in README; not re-tested)

Links out (do not duplicate)

• ‣ Datum → Reference