Forward Torrent
forward_torrentSend a torrent (filename + magnet) to the user's Telegram chat.
Instructions
Send a torrent (filename + magnet) to the user's Telegram chat.
The forward goes through the Torrent Search REST API, which owns the Telegram bot token; when PRUNE_MAGNET_LINKS is enabled the magnet is pruned to 'magnet:?xt=urn:btih:HASH&dn=' before sending. Requires TORRENT_SEARCH_API_KEY (same value as the API server) and TORRENT_SEARCH_API_URL. Forwards are rate-limited per chat (20/min).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"filename": "<filename>",
"magnet_link": "<magnet_link>",
"chat_id": "<chat_id>"
},
"name": "forward_torrent"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| size | No | Optional human-readable size (e.g. '1.2 GiB'). | |
| chat_id | Yes | The owner's Telegram chat id the torrent is sent to. | |
| seeders | No | Optional seeder count. | |
| filename | Yes | Exact torrent filename shown in the search results. | |
| magnet_link | Yes | Magnet link of the torrent (from get_torrent, or from a search run with INCLUDE_LINKS=true), as the bare magnet: drop the untrusted-data notice and tag lines, they are not part of the link and would break the forward. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |