Soulseek Featured MCP

Public MCP server for Soulseek search, browsing, downloads, rooms, and chat state.

Exposed tools

• search_files

• browse_user_shares

• browse_user_folder

• queue_download

• list_downloads

• list_saved_files

• read_saved_file_info

• delete_saved_file

• get_download_file_url

• list_rooms

• join_room

• leave_room

• say_room

• list_joined_rooms

• list_room_messages

• send_private_message

• list_private_chats

• list_private_messages

• watch_user

• get_auto_join_rooms

• set_auto_join_rooms

• reconnect_soulseek

• server_health

Auth

HTTP transport expects:

Authorization: Bearer <MCP_AUTH_TOKEN>

The interactive docs page does not embed the token; it asks for it client-side in the browser.

Default deploy path:

• MCP endpoint: /mcp

• Health endpoint: /health

• Docs endpoint: /docs

• Files endpoint: /files/:path

Required env

• MCP_AUTH_TOKEN

• SLSK_USER

• SLSK_PASS

Local run

For a local host run, override the container-only paths from .env.deploy:

set -a && . ./.env.deploy && set +a
DOWNLOAD_DIR="$(pwd)/downloads" \
AUTO_JOIN_ROOMS_FILE="$(pwd)/data/auto-join-rooms.json" \
node server.js