Model Context Protocol · 2024-11-05 · stdio
Drive unfetch from your AI assistant
unfetch ships with a built-in MCP server (--mcp) exposing 17 tools, live task://{id} resource subscriptions, and 4 Claude Skills — ready for Claude Desktop, Claude Code, Cursor, Codex, or any MCP host.
Option 1: One-command install for Claude Code (MCP + 4 Skills)
RecommendedRun these two commands in Claude Code to install both the MCP server and all 4 download skills:
/plugin marketplace add guangtoutong/unfetch
/plugin install unfetch@unfetch Option 2: Claude Desktop / Cursor / Standard MCP Config
Add this to claude_desktop_config.json or .mcp.json:
{
"mcpServers": {
"unfetch": {
"command": "/Applications/unfetch.app/Contents/MacOS/unfetch",
"args": ["--mcp"]
}
}
} {
"mcpServers": {
"unfetch": {
"command": "C:\\Program Files\\unfetch\\unfetch.exe",
"args": ["--mcp"]
}
}
} {
"mcpServers": {
"unfetch": {
"command": "unfetch",
"args": ["--mcp"]
}
}
} 17 Built-in MCP Tools
add_task req: url Add a download task — HTTP/S (with multi-mirror fan-out), FTP/FTPS/SFTP, magnet/torrent, ed2k, or 1000+ video sites
detect_url req: url Detect URL protocol and engine type (http / ftp / bt / ed2k / ytdlp)
preview_torrent req: url Preview files inside a magnet link or .torrent (returns file paths, sizes, and indices for selective download)
wait_for_task req: id Block until a task completes or fails while streaming live notifications/progress updates
wait_for_all Block until all active tasks (queued/downloading/paused) finish or timeout
list_tasks List all tasks (optional status filter: all / downloading / paused / done / error / queued)
get_task req: id Get full metadata, speed, ETA, peer count, and SHA256 verification status of a task
pause_task req: id Pause a running or queued download task
resume_task req: id Resume a paused or failed download task from its saved breakpoint
remove_task req: id Permanently delete a task (optional delete_file: true to remove local file)
trash_task req: id Move a task to the recycle bin (reversible, preserves downloaded data)
restore_task req: id Restore a single task from the recycle bin
empty_trash Permanently delete all tasks in the recycle bin and their local files
restore_all_trashed Restore all tasks currently in the recycle bin
get_config Read current daemon configuration (download_dir, threads, speed_limit, proxy, etc.)
set_config Update daemon configuration live without restarting
play_in_unflick req: path Open and play a downloaded media file in Unflick player
4 Bundled AI Skills
unfetch-grab Single-URL smart download with protocol detection, checksum verification & progress wait
unfetch-batch Bulk URL ingestion, mirror fan-out, and dependency chain orchestration
unfetch-media Video & audio extraction from 1000+ sites with quality selection (4K/1080p/audio)
unfetch-watch Queue health monitoring, slow-task uTP switching, and trash cleanup
Example Prompts
“Download this 4K video to ~/Downloads in 1080p, wait for it to finish, and open it in Unflick.”
“Preview the files in this magnet link first, then download only the main .mp4 video and .srt subtitle.”
“How many active downloads do I have? Pause anything larger than 2 GB.”