5mghost-yonder

Internal MCP server package for 5mghost workflows.

Quick Start

curl -fsSL https://mkterswingman.com/install/yt-mcp.sh | bash

powershell -ExecutionPolicy Bypass -Command "irm https://mkterswingman.com/install/yt-mcp.ps1 | iex"

The bootstrap installer:

• installs the npm package
• installs required runtimes (playwright, yt-dlp, ffmpeg)
• runs yt-mcp setup
• runs yt-mcp smoke to verify MCP startup and authenticated remote access
• opens a dedicated Playwright browser profile for YouTube login
• keeps cookie refresh inside the same dedicated profile (does not import system Chrome/Edge profiles)
• in unattended installs, defaults to OAuth auth mode and defaults to headed cookie setup after the prompt timeout
• in installer mode, OAuth waits up to 180s and prints PAT fallback commands before waiting
• if auth is still incomplete after setup, the installer stops before smoke tests and YouTube cookie setup instead of pretending the install fully passed
• runs a subtitle smoke check immediately after cookies are available

If you are working inside the repo instead of using the hosted installer:

bash scripts/install.sh

powershell -ExecutionPolicy Bypass -File .\scripts\install.ps1

yt-mcp stores first-party shared auth at ~/.mkterswingman/auth.json, so logging in here also covers other first-party local MCPs on the same machine. YouTube cookies remain local to ~/.yt-mcp/.

Client registration notes:

• setup auto-registers Claude/Codex/Gemini/OpenCode when their CLI supports mcp add
• OpenClaw is registered via mcporter config add --command ... --arg ... (native stdio mode)
• pasted PAT tokens are stored in ~/.mkterswingman/auth.json; client env.YT_MCP_TOKEN is optional after setup

Media download runtime expectations:

• start_download_job and poll_download_job are job-based local tools
• ffmpeg is required for video download modes
• each job handles up to 5 YouTube videos
• downloads are written to ~/Downloads/yt-mcp/YYYY-MM-DD_<video_id>

Commands

• setup — first-time setup
• serve — start the stdio MCP server
• smoke — run the installer smoke checks (search_videos, plus validate_cookies with --subtitles)
• runtime — install, update, or check required runtimes
• check — inspect shared auth, runtime status, and YouTube cookies
• setup-cookies — open a dedicated Playwright browser profile for manual YouTube login and save cookies locally
• uninstall — remove MCP registrations and local ~/.yt-mcp config
• update — update the main package and required runtimes
• version — print the installed version

Runtime notes:

• Playwright browser installs are managed through yt-mcp runtime install, not a raw npx playwright install ... call
• yt-dlp is invoked with --js-runtimes node, so no extra Deno install is required