plex-mcp-roadmap

plex-mcp-roadmap is a skill for Claude Code, Codex, Cursor from sandraschi/plexmcp. It costs 78 tokens per session (1,207 once invoked), scanned A, original, MIT.

A routing guide for adding advanced features to plex-mcp, a server that lets coding agents work with a Plex media library. It points each requested project to its own instructions.

In plain words
What is it for?
Use it when adding metadata enrichment, subtitle search, viewing-preference profiles, mood-based recommendations, episode summaries, or links between related films and shows.
Why use it?
It helps the agent choose the right project plan and follow the shared code layout and fixed ports. This avoids using the wrong instructions when building media features.

Skill for Claude CodeCodexCursor

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/sandraschi/plexmcp/plex-mcp-roadmap
Any agent
npx skills add sandraschi/plexmcp --skill plex-mcp-roadmap
Clone the repo
git clone --depth 1 https://github.com/sandraschi/plexmcp

Made for: Claude Code, Codex, Cursor.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for plex-mcp-roadmap

README.md
[![agentmods](https://agentmods.dev/badge/skills/sandraschi/plexmcp/plex-mcp-roadmap.svg)](https://agentmods.dev/skills/sandraschi/plexmcp/plex-mcp-roadmap)
Your own site
<a href="https://agentmods.dev/skills/sandraschi/plexmcp/plex-mcp-roadmap"><img src="https://agentmods.dev/badge/skills/sandraschi/plexmcp/plex-mcp-roadmap.svg" alt="Measured on agentmods" height="20"></a>
Per session 78 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,207 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00078 $0.01207
Opus 5 $0.00039 $0.00603
Sonnet 5 $0.00016 $0.00241
Haiku 4.5 $0.00008 $0.00121

Measured 3d ago against content hash ee00856cb9cc, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

plex-mcp-roadmap scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.cursor/skills/plex-mcp-roadmap/SKILL.md · 120 lines

How it starts

The opening of the file, as written. The whole thing — 120 lines — stays where its author put it; the contents beside it link to each section on GitHub.

plex-mcp Roadmap — Orchestrator

You are implementing features for plex-mcp, a FastMCP 3.2 server for Plex Media Server. Roadmap in docs/plans/ROADMAP.md with six child projects in the same directory.

Activate this skill when

The user asks to build any of:

  • Deep metadata enrichment (Wikipedia + TMDB + Letterboxd + IMDB + RT + Metacritic + Criterion)
  • Subtitle RAG (semantic search across all subtitles, with Whisper fallback)
  • Taste modelling (user preference profile from watch history)
  • Mood-based nightly picker (taste-aware "what to watch tonight")
  • Episode intelligence (per-episode summaries, character arcs, "recap before watching")
  • Cross-library linking (director/cast/adaptation/making-of pairs)

For any of these: read docs/plans/ROADMAP.md, then the per-project spec, then use the matching per-project skill.

Shared conventions

Layout

  • Main package: src/plex_mcp/
  • Tools: src/plex_mcp/tools/
  • Services: src/plex_mcp/services/
  • RAG: src/plex_mcp/rag/
  • Webapp backend: webapp/backend/app/
  • Webapp frontend: webapp/frontend/app/ (Next.js App Router)

Ports (never change)

  • Backend FastAPI + MCP HTTP: 10741
  • Frontend Next.js: 10742
  • Plex: 32400 (external)
  • Ollama: 11434 (external)

Tool patterns

All tools use @mcp.tool() via the global plex_mcp.server.mcp instance. New portmanteau tools: src/plex_mcp/tools/{category}/ manage_{thing}.py with Literal operation parameter.

REST pattern

Endpoints in webapp/backend/app/api/{feature}.py. Routers registered in webapp/backend/app/main.py. Frontend catch-all rewrite /api/:path* → :10741/api/:path* is already in place.

PlexAPI usage

All Plex interaction via plexapi (already a dep). Never make raw HTTP calls to Plex. Use the central PlexService singleton in src/plex_mcp/services/plex_service.py.

State DB

All user-state tables in the plex-mcp SQLite DB (not Plex's own metadata.db — NEVER write to that). New tables: include created_at, updated_at TIMESTAMP columns.

Read the full file on GitHub · 120 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 120 lines · 78 tokens per session scan A ee00856cb9cc

Subscribe to this mod's changes

plex-mcp-roadmap is a skill published in the GitHub repository sandraschi/plexmcp (2 stars, last pushed 16d ago), licensed MIT. It adds 78 tokens to every session and 1,207 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

blender-expert

Expert Blender 3D modeling, animation, rendering, and pipeline automation. Use for any Blender-related task from simple primitives to complex procedural workflows.

sandraschi/blender-mcp · 34 tokens

blender-mcp

Blender 3D automation via FastMCP — modeling, animation, rendering, scene management, materials, and more.

sandraschi/blender-mcp · 0 tokens

discord-rag

Retrieval-Augmented Generation over Discord message history. Ingest channel messages into a local LanceDB vector database, then search semantically — find messages about a topic even when the exact words don't match.

sandraschi/discord-mcp · 0 tokens

debug-evals

Debug haiku.rag evaluation runs in Logfire. Use when asked to look at Logfire for an eval run, find failing or low-scoring eval cases, compare runs, check citation quality (citedmap) or judge pass rate (answerequivalent), or explain why an eval case failed. Drives the Logfire MCP against the evals service, or the…

ggozad/haiku.rag · 103 tokens

debug-ingestion

Debug haiku.rag ingestion in Logfire. Use when asked to look at Logfire for ingestion, find failed or dead ingestion jobs, investigate retries or circuit-breaker events, trace a document through convert/chunk/embed/store, find which docling-serve instance served a request, spot slow conversions, or tell concurrent…

ggozad/haiku.rag · 87 tokens

autonomous-modeling

Use this skill to autonomously design and model complex 3D objects in Blender. Perfect for generating chassis, robots, and environment props from natural language.

sandraschi/blender-mcp · 36 tokens