Rtorrent
FreeNot checkedMCP server for rTorrent BitTorrent automation, enabling torrent management (add/list/pause/delete), multi-source searching (Nyaa, Pirate Bay, etc.), and post-pr
About
MCP server for rTorrent BitTorrent automation, enabling torrent management (add/list/pause/delete), multi-source searching (Nyaa, Pirate Bay, etc.), and post-processing workflows via natural language.
README
⛔ 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.
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 |
|---|---|
| Installation | All install methods, prerequisites, troubleshooting |
| Onboarding | First-time rTorrent + Anna's Archive setup |
| Architecture | Ports, tool surface, media pipeline, key files |
| Configuration | All environment variables and config options |
| Tool Reference | Every MCP tool and action, with examples |
| Development | Dev setup, tests, code style, contributing |
| Troubleshooting | Common issues and fixes |
| Extended Search Guide | Full guide to manga, movies, ebooks, comics, metadata search |
| *arr Integration | Wiring rTorrent as a Radarr/Sonarr download client |
| Product Requirements | Background and product rationale |
| Legal notice | Not-for-piracy stance, what this software is, issue policy |
| Lawful sourcing | What you may lawfully put through a client |
| Torrenting safety | Swarm visibility, VPN limits, malware, seeding liability |
| Country specifics | Austria, Germany, USA, UK, Japan enforcement (+ EMEA: FR/IT/NL/CH/ES) |
| VPN privacy | 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
Installing Rtorrent
This server has no published package — it is built from source. Open the repository and follow its README.
▸ github.com/sandraschi/rtorrent-mcpFAQ
Is Rtorrent MCP free?
Yes, Rtorrent MCP is free — one-click install via Unyly at no cost.
Does Rtorrent need an API key?
No, Rtorrent runs without API keys or environment variables.
Is Rtorrent hosted or self-hosted?
Self-hosted: the server runs locally on your machine via the install command above.
How do I install Rtorrent in Claude Desktop, Claude Code or Cursor?
Open Rtorrent on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.
Related MCPs
GitHub
PRs, issues, code search, CI status
by GitHubFilesystem
Secure file operations with configurable access controls.
Memory
Knowledge graph-based persistent memory system.
Template MCP Server
A CLI tool to create a new Model Context Protocol server project with TypeScript support, dual transport options, and an extensible structure
by mcpdotdirectServer Sequential Thinking
MCP server for sequential thinking and problem solving
by GitHub ActionsUnyly Deploy
Deploy sites and MCP servers to Unyly straight from your AI agent
by UnylyAmap Maps Mcp Server
MCP server for using the AMap Maps API
by duxiaohuiPayMCP
Lightweight payments layer for MCP servers: turn tools into paid endpoints with a two-line decorator. [PyPI](https://pypi.org/project/paymcp/) · [npm](https://w
by blustAIServer For Power BI
Enables exploring Microsoft Fabric / Power BI workspaces and semantic models, and executing ad-hoc DAX queries.
by Mitsubishi-FusoGpt Image 2 Mcp
RunAPI GPT Image 2 MCP server for image generation: create tasks, poll results, and check pricing across 1 model from Claude Code, Codex, Cursor, and VS Code.
by runapi-aiCompare Rtorrent with
Not sure what to pick?
Find your stack in 60 seconds
Author?
Embed badge for your README
Browse similar
All development MCPs
