delete_torrent
Delete a torrent and its files.
LABSCO SUMMARY
Read the two removal verbs before using either — one keeps what was downloaded and one does not.
forget_torrent stops tracking a torrent while leaving its files in place; delete_torrent takes both together. Everything else addresses a torrent the same way, by id or infohash, and the split between get_torrent_details and get_torrent_stats is what makes polling cheap: the static description and the live progress are separate reads, so watching a transfer does not mean re-reading its file list every time.
What it is
An rqbit client with 8 tools covering the whole life of a torrent — adding it, listing it, reading its detail and its live stats, suspending and resuming it, and removing it with or without the files it produced.
What you get
- download_torrent adds a torrent from a magnet link, an HTTP URL or a local file path.
- list_torrents for everything the client holds, with get_torrent_details and get_torrent_stats addressing one torrent by id or infohash.
- start_torrent and pause_torrent for resuming and suspending a transfer.
- Two removals with different consequences: forget_torrent drops the torrent and keeps the files, delete_torrent removes the torrent and its files.
Requirements
No account or key. The tools act on an rqbit instance, and the files a torrent produced live wherever that instance puts them.
Setup effort
One command — pip install rqbit-mcp
USE CASES
01
Starting a download from whatever form of the link you were given
A magnet link, an HTTP URL and a local .torrent file all go into the same call, so there is no branch to work out first.
02
Watching a transfer without re-reading its whole file list
Stats and details are separate reads, so polling progress stays small while the file listing is fetched once.
03
Freeing bandwidth for something else and putting it back afterwards
Pausing suspends a transfer without losing it, and starting resumes the same torrent rather than adding a second copy.
04
Clearing a finished torrent while keeping what it downloaded
Forgetting keeps the files and deleting does not, which makes the choice between them the whole decision.
8 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
download_torrent
Download a torrent from a magnet link, HTTP URL, or local file.
forget_torrent
Forget a torrent, keeping the files.
get_torrent_details
Get details for a specific torrent by its ID or infohash.
get_torrent_stats
Get stats and status for a specific torrent by its ID or infohash.
list_torrents
List all torrents.
pause_torrent
Pause a torrent.
start_torrent
Start (resume) a torrent.
BEFORE YOU INSTALL
What to know first
Tools you get
8 tools when we connected. forget_torrent removes the torrent but keeps its files; delete_torrent removes both.
Requires
- uvx on PATH
- Python 3.10+
Where it runs
All 4 documented setups run the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the 8 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
pip install rqbit-mcpMCP Clients
Windsurf — stdio
WINDSURF — STDIO · JSON
{
"mcpServers": {
"rqbit-mcp": {
"command": "uvx",
"args": [
"rqbit-mcp"
],
"env": {
"RQBIT_URL": "http://localhost:3030",
"RQBIT_HTTP_BASIC_AUTH_USERPASS": "<YOUR_USERNAME>:<YOUR_PASSWORD>"
}
}
}
}Windsurf — Docker
WINDSURF — DOCKER · JSON
{
"mcpServers": {
"rqbit-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"-p",
"8000:8000",
"-e",
"RQBIT_URL=http://localhost:3030",
"-e",
"RQBIT_HTTP_BASIC_AUTH_USERPASS=<YOUR_USERNAME>:<YOUR_PASSWORD>",
"philogicae/rqbit-mcp:latest",
"rqbit-mcp"
]
}
}
}Windsurf — SSE
Start the server in SSE mode first — it listens on port 8000 by default: pip install rqbit-mcp, then run rqbit-mcp --mode sse (with RQBIT_URL set, as in the .env example: RQBIT_URL=http://localhost:3030).
WINDSURF — SSE · JSON
{
"mcpServers": {
"rqbit-mcp": {
"serverUrl": "http://127.0.0.1:8000/sse"
}
}
}Windsurf — Streamable HTTP
Start the server in streamable HTTP mode first — it listens on port 8000 by default: pip install rqbit-mcp, then run rqbit-mcp --mode streamable-http (with RQBIT_URL set, as in the .env example: RQBIT_URL=http://localhost:3030).
WINDSURF — STREAMABLE HTTP · JSON
{
"mcpServers": {
"rqbit-mcp": {
"serverUrl": "http://127.0.0.1:8000/mcp"
}
}
}
