Slskd Search
slskd_searchSearch the Soulseek network for music files, albums, or artists, then filter by format and bitrate and rank matches by peer speed and queue.
Instructions
Search the Soulseek network for music files, albums, or artists.
Polls until responses arrive or timeout expires. Filters and ranks matches prioritizing peers with open upload slots, shorter queues, and higher speeds.
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": {
"query": "<query>"
},
"name": "slskd_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Search string (e.g. 'Aphex Twin Selected Ambient Works' or 'Sewerslvt'). | |
| max_results | No | Maximum number of ranked file results to return (default: 50). | |
| min_bitrate | No | Minimum bitrate in kbps for audio files (e.g. 320). Lossless files are preserved. | |
| format_filter | No | Optional file extension filter (e.g. 'flac', 'mp3', 'wav'). | |
| timeout_seconds | No | Search duration in seconds (default: 15, minimum: 5). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |