rtorrent-mcp
This server turns Claude into a full torrent client and download-automation assistant: search a dozen indexers, manage torrents, run named/language workflows, and post-process media into Plex/Jellyfin — backed by rTorrent or qBittorrent.
Torrent management: add magnet links, list, pause, resume, delete (optionally with files), check status, and fetch detailed torrent info
Search across sources: anime/manga/Japanese TV (nyaa.si), movies (YTS), ebooks (Anna's Archive, Project Gutenberg, Pirate Bay), comics, plus IMDb/TVDB metadata lookup
Natural-language commands: English or German requests like "get me this week's ASW anime in 720p" (execute, parse-only, or get help)
Automatic post-processing: detect completed downloads, rename/normalize filenames, sort media, and notify Plex/Jellyfin; start/stop the processing loop
Long-running workflows: download whole anime franchises or episode batches, estimate, queue, schedule, check status, and cancel jobs
Agentic orchestration: hand a natural-language goal to an LLM loop that autonomously calls tools (search, add, legal check)
Legal compliance helpers: Austrian-context risk assessment, content legality checks, and country/activity legal advice
System introspection: help docs, status, health metrics, server info/config, and repository analysis
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@rtorrent-mcp search for the latest episode of One Piece on Nyaa"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
rtorrent-mcp
⛔ Not for piracy.
This software does not help with copyright infringement — no infringing sources, no sourcing help, no configuration for infringing purposes. BitTorrent is neutral infrastructure with real lawful uses; this repo is for those. Read first: Legal notice · Lawful sourcing · Safety · Country specifics. Sourcing questions in issues are respectfully declined and closed.
Talk to Claude to add torrents, search anime/manga/movies/ebooks across half a dozen sites, and get finished downloads renamed and sorted into Plex or Jellyfin automatically.
What this wraps
rtorrent-mcp drives a torrent client over its automation interface — it
does not scrape a generic download site. Two backends, one tool surface
(TORRENT_BACKEND, default rtorrent):
rTorrent over XML-RPC/SCGI (not bundled; easiest via the included Docker Compose stack — see Quick Install below).
qBittorrent over its WebUI API v2 (native exe, no Docker needed). Set
TORRENT_BACKEND=qbittorrentplusQBITTORRENT_URL(andQBITTORRENT_API_KEYon ≥ v5.2.0, else username/password).
Full rTorrent setup, plugins, and troubleshooting: docs/RTORRENT_SETUP.md. Backend design, client coverage, and no-seed proof gates: docs/DUAL_BACKEND_SPEC.md.
Related MCP server: rutorrent-mcp
What You Can Do
How it runs: talks to your torrent backend (rTorrent over XML-RPC,
Docker recommended; or native qBittorrent over its WebUI API) plus a small
companion web dashboard (web_sota/) as a lightweight
alternative to the full ruTorrent WebUI bundled in the same Docker image.
Direction | Artifacts | Notes |
Hands-in | Magnet links, search queries, natural-language commands | Via MCP tools or the webapp |
Hands-out | Added/managed torrents, search results, renamed & sorted media files | Plex/Jellyfin libraries notified automatically |
Search anime (nyaa.si), manga, Japanese TV, movies (YTS), TV shows, ebooks (Anna's Archive, Project Gutenberg), and comics from one place
Add, pause, resume, and delete torrents; check status and health
Automatic post-processing: rename, move, and notify Plex/Jellyfin when a download completes
Natural-language commands in English or German ("get me this week's asw anime, 720p")
Franchise and batch-series download workflows
Austrian legal-context hints on search results (not legal advice)
Quick Install
Get rTorrent running:
docker compose up -d(see Onboarding)Download the latest
.mcpbfrom Releases and drag it onto Claude Desktop
That's it — no Python, git, or terminal required. Other install methods
(mcpb CLI, manual config, dev mode with just): INSTALL.md.
Example Prompts
"Get me this week's ASW anime in 720p"
"Search for The Matrix on YTS in 1080p"
"Check for completed downloads and notify Plex"
Documentation
Doc | Contents |
All install methods, prerequisites, troubleshooting | |
First-time rTorrent + Anna's Archive setup | |
Ports, tool surface, media pipeline, key files | |
All environment variables and config options | |
Every MCP tool and action, with examples | |
Dev setup, tests, code style, contributing | |
Common issues and fixes | |
Full guide to manga, movies, ebooks, comics, metadata search | |
Wiring rTorrent as a Radarr/Sonarr download client | |
Background and product rationale | |
Not-for-piracy stance, what this software is, issue policy | |
What you may lawfully put through a client | |
Swarm visibility, VPN limits, malware, seeding liability | |
Austria, Germany, USA, UK, Japan enforcement (+ EMEA: FR/IT/NL/CH/ES) | |
Justified uses, dual use, criteria, named providers, what fails |
Austrian context
This tool is built around the Austrian legal context, where personal downloading is generally tolerated, and includes AT-oriented risk hints on search results. Full picture (beyond Austria): Country specifics. Users in other jurisdictions should research local copyright law — high-risk countries (e.g. Germany, Japan) warrant extra caution. This is not legal advice.
Requirements
Python 3.13+ and uv
Docker Desktop (recommended, for running rTorrent)
Claude Desktop, or any MCP-compatible client
License
MIT — see LICENSE.
Acknowledgments
Available Tools
7 toolsagentic_rtorrent_workflowB
RTORRENT_AGENTIC_WORKFLOW - Multi-step torrent/search automation via sampling with tools.
PORTMANTEAU PATTERN RATIONALE: One entry point for LLM-orchestrated flows (search, add, legal check) without hard-coding sequences in the client.
Inputs: available_tools (required), workflow_prompt (required), max_iterations. Returns: object
legal_managementA
Comprehensive legal management portmanteau tool for Austrian copyright compliance.
PORTMANTEAU PATTERN RATIONALE: Instead of creating 4+ separate tools (one per operation), this tool consolidates related legal compliance operations into a single interface. Prevents tool explosion (4 tools → 1 tool) while maintaining full functionality and improving discoverability. Follows FastMCP 2.12+ best practices.
AUSTRIAN LEGAL CONTEXT (AT):
Sandra's Location: Vienna, 9th district
Personal downloading: Generally tolerated in Austria
Anime content: Low risk for personal consumption
Commercial use: NOT supported (high risk)
Germany/Japan: High risk, VPN mandatory
RISK LEVELS:
LOW: Safe for personal use (anime, manga for personal library)
MEDIUM: Caution advised (newly released content)
HIGH: VPN recommended (commercial content, high-profile releases)
CRITICAL: Not recommended (recent theatrical releases, games)
Inputs: action (required), country, activity, content_type, +1 more. Returns: object
nlp_managementB
Comprehensive NLP management portmanteau tool for natural language anime commands.
PORTMANTEAU PATTERN RATIONALE: Instead of creating 3+ separate tools (one per operation), this tool consolidates related NLP operations into a single interface. Prevents tool explosion (3 tools → 1 tool) while maintaining full functionality and improving discoverability. Follows FastMCP 2.12+ best practices.
LANGUAGE SUPPORT:
English: "get me this weeks asw anime, 720p"
German: "lade detective conan asw 720p"
Auto-detection enabled by default
COMMAND PATTERNS:
"[get/download/lade] [anime name] [group] [resolution]"
"asw [anime name] [resolution]"
"this weeks anime [group] [resolution]"
Inputs: action (required), text, language. Returns: object
search_managementB
Comprehensive search management portmanteau tool for torrents and metadata.
PORTMANTEAU PATTERN RATIONALE: Instead of creating 11+ separate tools (one per search type), this tool consolidates related search operations into a single interface. Prevents tool explosion (11 tools → 1 tool) while maintaining full functionality and improving discoverability. Follows FastMCP 2.12+ best practices.
SEARCH SOURCES:
nyaa.si: Anime, manga, Japanese TV (THE gold standard for anime)
YTS: Movies (gold standard for movie torrents)
Anna's Archive: Ebooks (60M+ books, 50M+ papers - THE gold standard!)
Pirate Bay: Comics, ebooks (fallback)
OMDb/TVDB: Metadata enrichment
Inputs: action (required), pin, year, group, +15 more. Returns: object
system_managementB
Comprehensive system management portmanteau tool.
PORTMANTEAU PATTERN RATIONALE: Instead of creating 5+ separate tools (one per operation), this tool consolidates related system operations into a single interface. Prevents tool explosion (5 tools → 1 tool) while maintaining full functionality and improving discoverability. Follows FastMCP 2.12+ best practices.
Inputs: action (required), level, topic. Returns: object
torrent_managementC
Comprehensive torrent management portmanteau tool for rTorrent and post-processing.
PORTMANTEAU PATTERN RATIONALE: Instead of creating 12 separate tools, this tool consolidates all torrent and post-processing operations into a single interface. Prevents tool explosion while maintaining full functionality.
Inputs: action (required), category, filename, magnet_link, +2 more. Returns: object
workflow_managementB
Complex workflow management portmanteau tool for multi-step torrent operations.
PORTMANTEAU PATTERN RATIONALE: Consolidates "tricky" long-running workflows into a single interface. Handles operations like downloading entire anime franchises that could take days.
Inputs: action (required), group, dry_run, rate_limit, +10 more. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool is a broad portmanteau with vaguely overlapping boundaries: search_management includes multi-step torrent/search workflows, workflow_management also covers multi-step torrent operations, and nlp_management can initiate search/download commands. An agent cannot reliably determine which tool should handle a given request without seeing hidden internal operations.
All tool names follow the same snake_case {domain}_management pattern, so the naming convention is predictable and consistent. However, the common suffix is a vague noun rather than an action verb, and names like system_management give little clue about what operations are actually available.
The raw count of seven tools is numerically reasonable, but each tool explicitly bundles three to twelve or more operations into a single interface. This makes the server feel under-differentiated for its broad scope and hides the true behavioral surface behind a small number of overloaded tools.
The set nominally covers the main areas of an rtorrent automation server: search, legal compliance, natural-language commands, system control, torrent/post-processing, and workflows. However, because every operation is hidden inside opaque mega-tools, completeness is asserted rather than verifiable, and agents cannot enumerate or confidently rely on the actual operations available.
Maintenance
Related MCP Connectors
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Official Todoist MCP server. Manage tasks and projects. Hosted, no API key needed.
One MCP server for all web data. Scrape, search, crawl, and AI research in one install.
MCP server for generating rough-draft project plans from natural-language prompts.
Related MCP Servers
- AlicenseAqualityCmaintenanceMCP server for managing a media server stack (Plex, Radarr, Overseerr, Bazarr, Prowlarr, Trakt.tv) using natural language to browse, request, and discover content.12MIT
- FlicenseAqualityDmaintenanceMCP server for controlling rTorrent through ruTorrent's httprpc plugin, enabling torrent management (list/add/remove/start/stop), label/priority management, data movement, and global throttle settings from any MCP client.132-
- AlicenseNot gradedqualityDmaintenanceAn MCP server that replicates Sonarr/Radarr/Lidarr functionality driven by an LLM, enabling automated torrent management for TV shows and movies.MIT
- AlicenseNot gradedqualityDmaintenanceMCP server that enables local LLMs to manage a home media stack including Radarr, Sonarr, Prowlarr, and others.MIT