Add Torrent to Transmission
transmission_add_torrentAdd torrents to Transmission from magnet links, HTTP URLs, or base64-encoded .torrent files. Set download directory, pause, or labels as needed.
Instructions
Add a new torrent to Transmission from a magnet URI, HTTP(S) URL, or base64-encoded .torrent file.
This tool adds torrents to the Transmission download queue. It supports multiple input formats and allows configuration of download location, initial state, and labels.
Args:
torrent (string): Magnet URI (magnet:?...), HTTP(S) URL to .torrent file, or base64-encoded .torrent file content
download_dir (string, optional): Destination directory for downloaded files
paused (boolean, optional): If true, add torrent in paused state (default: false)
labels (string[], optional): Array of labels to apply to the torrent
response_format ('markdown' | 'json'): Output format (default: 'markdown')
Returns: For JSON format: { id: number, name: string, hashString: string } For Markdown format: Human-readable confirmation with torrent details
Examples:
Use when: "Add this magnet link to downloads" -> params with magnet URI
Use when: "Download torrent from URL and label it 'movies'" -> params with URL and labels
Don't use when: You need to search for torrents (this only adds existing torrent files/magnets)
Error Handling:
Returns "Error: Could not connect to Transmission daemon" if connection fails
Returns "Torrent added successfully" on success with torrent details
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| labels | No | Labels to apply to the torrent | |
| paused | No | If true, torrent will be added in paused state | |
| torrent | Yes | Magnet URI, URL to .torrent file, or base64-encoded .torrent file content | |
| download_dir | No | Destination path for downloaded files | |
| response_format | No | Output format: 'markdown' for human-readable or 'json' for machine-readable | markdown |