Soulseek

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