MCP server

Drive TurboDL from an AI assistant (Claude Code, Claude Desktop…).

turbodl-mcp is a Model Context Protocol server over stdio. Downloads run in its process, with the TurboDL engine.

Client configuration

Claude Code:

claude mcp add turbodl -- turbodl-mcp --profile ~/.config/turbodl/default.profile.json

Claude Desktop (claude_desktop_config.json) or any compatible client:

{
  "mcpServers": {
    "turbodl": {
      "command": "turbodl-mcp",
      "args": ["--profile", "C:/Users/me/AppData/Roaming/turbodl/default.profile.json"]
    }
  }
}

Without --profile, the default profile is used (and created when missing).

Tools

Tool	Parameters	Result
`download`	`url`, `profile?`, `filename?`	Starts in the background; returns the `id` and a first state
`status`	`id`	State, %, bytes, speed, time left, threads, path or error
`list`	—	Every download of the server
`pause`	`id`	Pauses (progress kept)
`resume`	`id`	Resumes where it stopped
`cancel`	`id`	Cancels and deletes the partial file
`wait`	`id`, `timeout_secs?` (60, max 600)	Waits for the end and returns the state, without polling
`detect_category`	`name_or_url`	Category according to the profile
`stats`	`period?` (`7d`, `30d`, `12m`, `all`)	Figures, breakdowns and insights

Security

Files always go into the profile's folder (or its category sub-folder).
filename must be a plain name: ../x or a path is refused.
Only http(s) URLs are accepted.
Answers contain no secret.