rtorrent-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| DEBUG | No | Enable debug mode | false |
| API_KEY | No | Bearer/X-API-Key auth for REST API (optional, set to enable) | |
| PLEX_URL | No | Plex server URL (enables library refresh after post-process) | |
| LOG_LEVEL | No | Logging level (DEBUG, INFO, WARNING, ERROR, CRITICAL) | INFO |
| PLEX_TOKEN | No | Plex authentication token | |
| JELLYFIN_URL | No | Jellyfin server URL (enables library scan after post-process) | |
| OMDB_API_KEY | No | OMDb API key for IMDb metadata (free at omdbapi.com) | |
| TVDB_API_KEY | No | TVDB API key for TV metadata (requires subscription) | |
| NYAA_BASE_URL | No | Nyaa.si base URL | https://nyaa.si |
| RTORRENT_HOST | No | rTorrent SCGI host | localhost |
| RTORRENT_PATH | No | rTorrent session path | /var/lib/rtorrent/session |
| RTORRENT_PORT | No | rTorrent XML-RPC port | 12224 |
| JELLYFIN_API_KEY | No | Jellyfin API key | |
| INGESTION_TV_PATH | No | Path to temporary ingestion folder for TV shows | |
| NYAA_ASW_USERNAME | No | ASW user page on nyaa.si for direct lookup | AkihitoSubsWeeklies |
| ALLOWED_CATEGORIES | No | Allowed content categories | ["Anime"] |
| DEFAULT_RESOLUTION | No | Default video resolution | 720p |
| PIRATEBAY_BASE_URL | No | The Pirate Bay domain (changes frequently) | https://thepiratebay10.xyz |
| ALLOWED_RESOLUTIONS | No | Allowed video resolutions | ["720p", "1080p"] |
| MAX_TORRENT_SIZE_GB | No | Maximum allowed torrent size in GB | 10 |
| NORMALIZE_FILENAMES | No | Normalize filenames before moving | true |
| INGESTION_ANIME_PATH | No | Path to temporary ingestion folder for anime | |
| INGESTION_MOVIES_PATH | No | Path to temporary ingestion folder for movies | |
| POST_PROCESSING_ENABLED | No | Enable automatic post-processing | false |
| PREFERRED_RELEASE_GROUP | No | Preferred release group | ASW |
| RTORRENT_SAMPLING_MODEL | No | LLM model for agentic workflow | llama3.2 |
| RTORRENT_SAMPLING_BASE_URL | No | OpenAI-compatible LLM endpoint (Ollama default) | http://127.0.0.1:11434/v1 |
| DELETE_TORRENT_AFTER_COMPLETE | No | Remove torrent after completion | true |
| POST_PROCESSING_POLL_INTERVAL | No | Seconds between polling for completed downloads | 60 |
| RTORRENT_SAMPLING_USE_CLIENT_LLM | No | Set to `1` to prefer host LLM over server-side |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| extensions | {
"io.modelcontextprotocol/ui": {}
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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. |
| 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:
|
| 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:
COMMAND PATTERNS:
|
| 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):
RISK LEVELS:
|
| 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. |
| 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. |
| 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. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| anime_search_prompt | Prompt template for searching anime with Austrian preferences. |
| franchise_download_prompt | Prompt template for downloading entire anime franchise. |
| legal_check_prompt | Prompt template for checking legal status of torrenting. |
| tv_show_search_prompt | Prompt template for searching Western TV shows. |
| ebook_search_prompt | Prompt template for searching ebooks. |
| torrent_workflow_prompt | Prompt template for standard torrent workflow. |
| system_status_prompt | Prompt template for checking system status. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| rtorrent-mcp/SKILL.md | Automate rTorrent via XML-RPC with Nyaa search, legal (AT) checks, and portmanteau MCP tools. |
| rtorrent-mcp/_manifest | File listing for rtorrent-mcp |
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.