Skip to main content
Glama
sandraschi

rtorrent-mcp

by sandraschi
OverviewSchemaRelated ServersScoreDiscussions
Python
Hybrid

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
DEBUGNoEnable debug modefalse
API_KEYNoBearer/X-API-Key auth for REST API (optional, set to enable)
PLEX_URLNoPlex server URL (enables library refresh after post-process)
LOG_LEVELNoLogging level (DEBUG, INFO, WARNING, ERROR, CRITICAL)INFO
PLEX_TOKENNoPlex authentication token
JELLYFIN_URLNoJellyfin server URL (enables library scan after post-process)
OMDB_API_KEYNoOMDb API key for IMDb metadata (free at omdbapi.com)
TVDB_API_KEYNoTVDB API key for TV metadata (requires subscription)
NYAA_BASE_URLNoNyaa.si base URLhttps://nyaa.si
RTORRENT_HOSTNorTorrent SCGI hostlocalhost
RTORRENT_PATHNorTorrent session path/var/lib/rtorrent/session
RTORRENT_PORTNorTorrent XML-RPC port12224
JELLYFIN_API_KEYNoJellyfin API key
INGESTION_TV_PATHNoPath to temporary ingestion folder for TV shows
NYAA_ASW_USERNAMENoASW user page on nyaa.si for direct lookupAkihitoSubsWeeklies
ALLOWED_CATEGORIESNoAllowed content categories["Anime"]
DEFAULT_RESOLUTIONNoDefault video resolution720p
PIRATEBAY_BASE_URLNoThe Pirate Bay domain (changes frequently)https://thepiratebay10.xyz
ALLOWED_RESOLUTIONSNoAllowed video resolutions["720p", "1080p"]
MAX_TORRENT_SIZE_GBNoMaximum allowed torrent size in GB10
NORMALIZE_FILENAMESNoNormalize filenames before movingtrue
INGESTION_ANIME_PATHNoPath to temporary ingestion folder for anime
INGESTION_MOVIES_PATHNoPath to temporary ingestion folder for movies
POST_PROCESSING_ENABLEDNoEnable automatic post-processingfalse
PREFERRED_RELEASE_GROUPNoPreferred release groupASW
RTORRENT_SAMPLING_MODELNoLLM model for agentic workflowllama3.2
RTORRENT_SAMPLING_BASE_URLNoOpenAI-compatible LLM endpoint (Ollama default)http://127.0.0.1:11434/v1
DELETE_TORRENT_AFTER_COMPLETENoRemove torrent after completiontrue
POST_PROCESSING_POLL_INTERVALNoSeconds between polling for completed downloads60
RTORRENT_SAMPLING_USE_CLIENT_LLMNoSet to `1` to prefer host LLM over server-side

Capabilities

Features and capabilities supported by this server

CapabilityDetails
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

NameDescription
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_managementA

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

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]"

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)

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

NameDescription
anime_search_promptPrompt template for searching anime with Austrian preferences.
franchise_download_promptPrompt template for downloading entire anime franchise.
legal_check_promptPrompt template for checking legal status of torrenting.
tv_show_search_promptPrompt template for searching Western TV shows.
ebook_search_promptPrompt template for searching ebooks.
torrent_workflow_promptPrompt template for standard torrent workflow.
system_status_promptPrompt template for checking system status.

Resources

Contextual data attached and managed by the client

NameDescription
rtorrent-mcp/SKILL.mdAutomate rTorrent via XML-RPC with Nyaa search, legal (AT) checks, and portmanteau MCP tools.
rtorrent-mcp/_manifestFile listing for rtorrent-mcp

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/sandraschi/rtorrent-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server