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)

Recommended

Run 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.”