mcp-slskd
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-slskdsearch for 'Bohemian Rhapsody' by Queen"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP Soulseek (slskd)
Model Context Protocol (MCP) server for searching and downloading music from the Soulseek peer-to-peer network via slskd.
This server exposes Soulseek's search and download capabilities as MCP tools, allowing AI assistants (Claude, Hermes, etc.) to discover and download music directly.
Tools
Tool | Description |
| Search for music files on Soulseek |
| Download a file from a user |
| Check progress of active downloads |
| Browse a user's shared files |
| Get cached results from last search |
Related MCP server: slskd-mcp
Prerequisites
slskd instance running and connected to Soulseek
Python 3.11+
Quick Start
1. Environment
export SLSKD_HOST="http://localhost:5030"
export SLSKD_USER="slskd"
export SLSKD_PASS="slskd"2. Run with uv (recommended)
uv run python -m mcp_slskd3. Run with pip
pip install mcp slskd-api
python -m mcp_slskd4. Run with Docker
docker run -e SLSKD_HOST=http://host.docker.internal:5030 \
-e SLSKD_USER=slskd \
-e SLSKD_PASS=slskd \
ghcr.io/ldgnu/mcp-slskd:latestDocker Compose
services:
slskd:
image: slskd/slskd:latest
ports:
- "5030:5030"
volumes:
- ./slskd_data:/app/data
mcp-slskd:
image: ghcr.io/ldgnu/mcp-slskd:latest
environment:
SLSKD_HOST: "http://slskd:5030"
SLSKD_USER: "slskd"
SLSKD_PASS: "slskd"
depends_on:
- slskdMCP Client Configuration
Hermes Agent
Add to your config.yaml:
mcp_servers:
slskd:
command: docker
args: [run, -i, --rm, --network=host,
-e, SLSKD_HOST=http://localhost:5030,
-e, SLSKD_USER=slskd,
-e, SLSKD_PASS=slskd,
ghcr.io/ldgnu/mcp-slskd:latest]Claude Desktop
{
"mcpServers": {
"soulseek": {
"command": "docker",
"args": ["run", "-i", "--rm", "--network=host",
"-e", "SLSKD_HOST=http://localhost:5030",
"-e", "SLSKD_USER=slskd",
"-e", "SLSKD_PASS=slskd",
"ghcr.io/ldgnu/mcp-slskd:latest"
]
}
}
}Configuration
Variable | Default | Description |
|
| slskd API endpoint |
|
| API key (alternative to user/pass) |
|
| slskd web UI username |
|
| slskd web UI password |
Note: Change default credentials in production. slskd uses token-based auth internally.
API
This server wraps the slskd REST API.
License
MIT
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseCqualityCmaintenanceDeezer MCP server for AI agents to search, manage playlists, favorites, and discover music using a free Deezer account.Last updated291MIT
- Alicense-qualityDmaintenanceAn MCP server that gives AI agents full control over slskd, a modern Soulseek client, enabling search, download, browse peers, monitor transfers, and manage the slskd instance.Last updated1MIT
- Alicense-qualityDmaintenanceMCP server that enables AI assistants to search and retrieve music data (songs, lyrics, playlists, albums, artists) from Netease Cloud Music.Last updatedMIT
- Flicense-qualityDmaintenanceAn MCP server that enables AI assistants to log into Soulseek, search the network, and download files through simple tool calls.Last updated
Related MCP Connectors
MCP server for Producer/Riffusion AI music generation
MCP server for Suno AI music generation, lyrics, and covers
Personal assistant MCP server with search, execute, packages, jobs, secrets, and integrations.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/ldgnu/mcp-slskd'
If you have feedback or need assistance with the MCP directory API, please join our Discord server