DOCS

How Deepcut works.

Deepcut searches YouTube, resolves track matches, filters bad versions, and builds playlists directly on your account.
QUICKSTART

From prompt to playlist in minutes.

1. Connect MCP→2. Authorize YouTube→3. Ask naturally

Example: build me a 25-song late-night playlist like Khruangbin and Glass Beams

HOW IT WORKS
PROMPT→SEARCH→RESOLVE→REJECT BAD VERSIONS→BUILD

Deepcut searches several YouTube candidates, scores them, hydrates details when useful, and refuses weak matches instead of silently guessing.

CORE ACTIONS

list_my_playlists — show your playlists

resolve_tracks — preview likely matches before writing

build_playlist_from_tracks — main playlist builder

add_videos_to_playlist — add and dedupe tracks

update / reorder / remove / delete — manage existing playlists with confirmation safeguards

MATCHING LOGIC

✓ Prefers official audio/video and artist releases

✓ Boosts artist/channel/title agreement

✓ Filters karaoke, covers, reactions, tutorials

✓ Avoids sped-up, nightcore, bass-boosted and loop edits

✓ Penalizes live/remix/instrumental unless requested

✓ Returns runners-up when confidence is too low

SAFETY & TRUST

Private by default. New playlists default to private.

Confirm destructive actions. Delete/remove tools require explicit confirmation.

OAuth credentials stay server-side. They are not intentionally exposed in model-visible tool output.

Quota aware. Deepcut checks whether long jobs can finish before starting them.

CONNECTIONS

Production uses one hosted MCP endpoint for ChatGPT, Claude, Cursor, and other compatible clients.

https://your-deepcut-host/mcp

Local developers can also use stdio mode with node dist/index.js.

EXAMPLE PROMPTS
build me a playlist like Khruangbinmake a 20-song gym playlistfind official versions onlyadd 10 tracks to my road trip playlistremove duplicates from this playlist

Default YouTube API quota is 10,000 units/day per Google project. Heavy public use requires a quota increase.