Skip to main content
Glama

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=qbittorrent plus QBITTORRENT_URL (and QBITTORRENT_API_KEY on ≥ 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

  1. Get rTorrent running: docker compose up -d (see Onboarding)

  2. Download the latest .mcpb from 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

  • rTorrent — the lightweight torrent client

  • Nyaa.si — anime torrent indexer

  • FastMCP — the MCP server framework

Available Tools

7 tools
agentic_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

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

    B3/5.0

    Scored across 7 tools

    Disambiguation2/5

    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.

    Naming Consistency4/5

    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.

    Tool Count3/5

    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.

    Completeness3/5

    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

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      MCP server for managing a media server stack (Plex, Radarr, Overseerr, Bazarr, Prowlarr, Trakt.tv) using natural language to browse, request, and discover content.
      12
      MIT
    • F
      license
      A
      quality
      D
      maintenance
      MCP 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.
      13
      2
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that replicates Sonarr/Radarr/Lidarr functionality driven by an LLM, enabling automated torrent management for TV shows and movies.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server that enables local LLMs to manage a home media stack including Radarr, Sonarr, Prowlarr, and others.
      MIT