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.
npx skills add Knuckles-Team/jellyfin-mcp --skill jellyfin-media-playbackgit clone --depth 1 https://github.com/Knuckles-Team/jellyfin-mcpWrote 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.
[](https://agentmods.dev/skills/knuckles-team/jellyfin-mcp/jellyfin-media-playback)<a href="https://agentmods.dev/skills/knuckles-team/jellyfin-mcp/jellyfin-media-playback"><img src="https://agentmods.dev/badge/skills/knuckles-team/jellyfin-mcp/jellyfin-media-playback/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/knuckles-team/jellyfin-mcp/jellyfin-media-playback"><img src="https://agentmods.dev/badge/skills/knuckles-team/jellyfin-mcp/jellyfin-media-playback.svg" alt="Reviewed on agentmods" width="80" height="20"></a>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.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00142 | $0.01044 |
| Opus 5 | $0.00071 | $0.00522 |
| Sonnet 5 | $0.00028 | $0.00209 |
| Haiku 4.5 | $0.00014 | $0.00104 |
Grade A, and why
jellyfin-media-playback 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 12d 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.
How it starts
The opening of the file, as written. The whole thing — 90 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Jellyfin Media Playback
Domain-typed streaming, music browsing, and playback control through the
jellyfin_media condensed tool. Prefer it over raw HTTP — it action-routes to the
media client methods (artists, streams, playlists, playstate).
When to use
- List artists / album artists (
get_artists,get_album_artists) and music genres (get_music_genres). - Manage playlists (
create_playlist,add_item_to_playlist,get_playlist_items) and build instant mixes (get_instant_mix_from_song). - Resolve streams (
get_audio_stream,get_video_stream,get_universal_audio_stream) and playback info (get_playback_info). - Drive playstate (
play,mark_played_item,report_playback_progress).
When NOT to use
- Browsing/searching items, collections, user views →
jellyfin-library-catalog. - Users, keys, backups, config → the
jellyfin_systemtool. - Ingesting artists/media into the KG →
jellyfin-kg-ingestion.
Prerequisites & environment
Connect via the mcp-client skill against the jellyfin-mcp MCP server.
| Variable | Required | Notes |
|---|---|---|
JELLYFIN_URL |
✅ | Base server URL |
JELLYFIN_API_KEY / JELLYFIN_TOKEN |
✅ | X-Emby-Token API key |
JELLYFIN_USER_ID |
optional | Default user_id for playstate/favorites |
JELLYFIN_VERIFY_SSL |
optional | TLS verification toggle |
MCP_TOOL_MODE selects the condensed surface below vs. the verbose 1:1 tools.
Tools & actions
Prefer the condensed tool with action + a params_json JSON string.
| Condensed tool | Actions |
|---|---|
jellyfin_media |
get_artists, get_album_artists, get_artist_by_name, get_music_genres, create_playlist, add_item_to_playlist, get_playlist_items, get_instant_mix_from_song, get_audio_stream, get_video_stream, get_universal_audio_stream, get_playback_info, play, mark_played_item, report_playback_progress, get_lyrics |
Key parameters
item_id— required for stream/playstate/lyrics/instant-mix actions.user_id— required for playstate + favorites (defaults to env).body— object payload forcreate_playlist/report_playback_*.search_term/limit/start_index— filter + paginate artist lists.
What ships with it
1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
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.
- 12d ago First seen · 90 lines · 142 tokens per session scan A 9b22383032ec
jellyfin-media-playback is a skill published in the GitHub repository Knuckles-Team/jellyfin-mcp (3 stars, last pushed 15d ago), licensed MIT. It adds 142 tokens to every session and 1,044 once invoked, about $0.0007 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.
Other skills, from other repositories
documentdb-collection-admin
Database, collection, and user administration on a DocumentDB (MongoDB-compatible, PostgreSQL-backed) server via the documentdb-mcp MCP server — list/create/drop/rename databases and collections, and manage database users and their roles. Use when the agent must provision or tear down namespaces, enumerate the…
documentdb-document-crud
Document create/read/update/delete operations on a DocumentDB (MongoDB-compatible, PostgreSQL-backed) collection via the documentdb-mcp MCP server — insert one/many, find with filter/sort/skip/limit, update/replace one/many, delete, count, and the atomic find-and-modify variants. Use when the agent must read or mutate…
documentdb-aggregation-analytics
Read-only analytics on a DocumentDB (MongoDB-compatible, PostgreSQL-backed) collection via the documentdb-mcp MCP server — run aggregation pipelines ($match/$group/$sort/…) and fetch distinct field values. Use when the agent must summarize, group, or profile documents rather than fetch individual rows. Do NOT use for…
nextcloud-files
Browse and manage Nextcloud files and folders over WebDAV via the nextcloud-agent MCP server — list a directory, read/download a file, upload, create/delete/move/copy, and read properties. Use when the agent must navigate a Nextcloud file tree, fetch a document's bytes, or reorganize storage. Do NOT use for sharing…
nextcloud-ingest
Natively ingest Nextcloud files into the epistemic-graph knowledge graph via the nextcloud-agent MCP server — fetch a file over WebDAV and store its raw bytes as a content-addressed :Blob/:AssetOccurrence plus its extracted text (pdf/office/txt or image OCR) as a linked :Document. Use when the agent must make a…
nextcloud-shares
Manage Nextcloud sharing grants over the OCS Sharing API via the nextcloud-agent MCP server — list existing shares, create a public link / user / group share on a file or folder, and revoke a share. Use when the agent must expose a file, audit who has access, or tear a share down. Do NOT use for browsing or moving…