Skip to main content
Glama
tuanht

transmission-mcp

by tuanht
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

transmission-mcp

MCP server (streamable HTTP, /mcp on port 8650) that lets an agent send magnet links to Transmission and check whether they are downloading.

Tools

  • add_magnet(magnet, download_dir?, paused?): validates the magnet, adds it, reports duplicates.

  • get_torrent_status(hash_or_id): verdict (downloading, stalled, fetching_metadata, queued, checking, paused, complete, seeding, error) plus progress, speed, peers, ETA.

  • list_torrents(verdict?)

  • pause_torrent(hash_or_id) / resume_torrent(hash_or_id)

Related MCP server: Transmission MCP Server

Config (environment)

Variable

Default

TRANSMISSION_URL

http://host.containers.internal:9091/transmission/rpc

TRANSMISSION_USER / TRANSMISSION_PASSWORD

unset (no auth)

MCP_HOST / MCP_PORT

0.0.0.0 / 8650

Quick start

Both methods serve the MCP endpoint at http://127.0.0.1:8650/mcp. You need a reachable Transmission RPC endpoint (set TRANSMISSION_URL); .env.example lists the variables.

Option 1: Docker Compose

cp .env.example .env            # edit TRANSMISSION_URL / credentials
docker compose up --build

No Transmission yet? Start a bundled one alongside (web UI on http://127.0.0.1:9091, downloads in ./downloads):

docker compose --profile transmission up --build

With the bundled daemon, set TRANSMISSION_URL=http://transmission:9091/transmission/rpc (the default).

Option 2: Run Python directly

Requires Python 3.11+.

With uv:

uv sync
TRANSMISSION_URL=http://127.0.0.1:9091/transmission/rpc uv run transmission-mcp

With plain pip:

python -m venv .venv && . .venv/bin/activate
pip install .
TRANSMISSION_URL=http://127.0.0.1:9091/transmission/rpc transmission-mcp

Develop

uv sync && uv run pytest
uv run transmission-mcp

Container (Podman)

podman build -t localhost/transmission-mcp:latest .

The Quadlet unit lives in the hermes-desktop repo (quadlet/transmission-mcp.container), joins the hermes pod, and is reached by Hermes at http://127.0.0.1:8650/mcp. There is no auth; do not expose the port.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • qBittorrent MCP

    pickpppcc
    F
    license
    Not graded
    quality
    F
    maintenance
    A service that provides programmatic access to qBittorrent's WebUI API, enabling management of torrents, trackers, tags, speed controls, and system information through natural language.
    29
    -

  • Transmission MCP Server

    cronus42
    A
    license
    Not graded
    quality
    D
    maintenance
    Provides tools for interacting with the Transmission BitTorrent client via natural language, enabling users to manage torrents, configure download settings, and monitor download activity.
    2
    MIT

  • qBittorrent MCP Server

    jabberjabberjabber
    F
    license
    A
    quality
    D
    maintenance
    Enables interaction with qBittorrent through its Web API to search for torrents using search plugins and manage downloads. Supports torrent searching, downloading via URLs/magnet links, and torrent management operations like pause, resume, and delete.
    7
    3
    -

  • transmission-mcp-server

    dgoo2308
    F
    license
    Not graded
    quality
    D
    maintenance
    Enables controlling a Transmission torrent daemon, allowing adding, listing, controlling torrents and checking free space, with support for SOCKS5 proxy for remote access.
    -