Skip to main content
Glama
transmission-mcp

transmission-mcp

by tuanht

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: qBittorrent 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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • 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.
      4
      MIT
    • 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
      -
    • 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.
      -
    • A
      license
      A
      quality
      B
      maintenance
      Enables driving a Transmission daemon from Claude.ai and Claude Code, exposing every RPC method as a tool for torrent, session, queue, and bandwidth management across both protocol generations.
      27
      MIT