download
Download a file from a Soulseek peer and save it to the configured local directory. After starting the download, wait before polling for status to allow the peer connection to establish.
Instructions
Download a file from a Soulseek peer.
Files are saved to the directory configured by SLSK_DOWNLOAD_DIR.
IMPORTANT: After calling this, SLEEP for at least 30 seconds (or do other productive work) before calling download_status. P2P connections take time to establish — the peer must accept, negotiate, and begin sending data. Checking immediately wastes tokens and will always show 0%.
The response includes wait_before_poll_secs — you MUST sleep/wait that many seconds before your first status poll. Do not live-poll in a loop.
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": {
"id": "<id>"
},
"name": "download"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes |