StreamerSongList MCP Server
This MCP server provides comprehensive access to StreamerSongList data, enabling LLMs like Claude to interact with live streamer song libraries, queues, and streaming statistics.
Core Capabilities:
Streamer Information - Fetch detailed streamer configuration and comprehensive statistics
Queue Management - View current queues with pagination, monitor real-time changes with configurable intervals, and access queue statistics (total songs, duration, popular tracks)
Song Library & Discovery - Search songs by title, artist, or genre with advanced filtering, and retrieve detailed metadata for specific songs
Song Attributes - Get, add, remove, or list tags and attributes for better organization
Song Requests - Create, update, and delete song requests with optional messages and requester information
Play History - Access performance history with date filtering and pagination
Statistics & Analytics - Get comprehensive streaming analytics over various time periods (day/week/month/year/all)
Overlay Data - Retrieve overlay configuration and display data for queue, now playing, history, or stats
Key Features: Real StreamerSongList API data (no mocking), no authentication required for public endpoints, optional default streamer configuration, pagination support for large datasets, and real-time monitoring capabilities.
Click on "Deploy 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., "@StreamerSongList MCP Server show me the current song queue for belleune"
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.
StreamerSongList MCP Server
MCP server exposing read-only StreamerSongList tools. Use LLM's to interface with a Live Streamers Song list. Claude Desktop and any MCP client.
Quick Start
Node.js 18+ required
Claude Desktop recommended for daily use
Add to Claude Desktop via npx:
{
"mcpServers": {
"streamersonglist": {
"command": "npx",
"args": ["streamersonglist-mcp"]
}
}
}See claude-desktop-config.with-default-streamer.json for an example with DEFAULT_STREAMER configured.
Click on the smithery badge to test out the mcp server or deploy your own.
Optional Smithery install (requires Smithery account):
# First login to Smithery (one-time setup)
npx -y @smithery/cli login
# Then install the MCP server
npx -y @smithery/cli install @vuvuvu/streamersonglist-mcp --client claudeRelated MCP server: Spotify MCP Server
Deploy to Smithery.ai
Want to test this MCP server instantly without any local setup? Click the Smithery badge above or visit:
Smithery.ai provides a hosted environment where you can:
Test all StreamerSongList tools immediately in your browser
No installation or configuration required
Perfect for trying out the server before local setup
Great for sharing with others or quick demonstrations
Simply click the badge at the top of this README or the link above to get started instantly!
Inspect / Debug (Recommended)
Use the MCP Inspector to explore tools and run requests interactively:
npx @modelcontextprotocol/inspector@latest -- npx streamersonglist-mcp
# or from a local clone
npx @modelcontextprotocol/inspector@latest -- node src/server.jsAlternative (raw stdio):
npm start
printf '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}\n' | node src/server.jsAvailable Tools (6 Total)
✅ All Real API Data (6 tools)
getStreamerByName — Fetch comprehensive streamer configuration
getQueue — List current song queue with pagination
getSongs — Fetch complete song list with pagination
searchSongs — Search songs by title or artist
getSongDetails — Get detailed information about a specific song
monitorQueue — Monitor queue changes using real data
Usage Examples
For comprehensive examples of how to use these tools, see docs/USAGE_EXAMPLES.md including:
🎵 Music discovery and analysis
📊 Content creator tools and stream planning
🤖 AI assistant integration and smart recommendations
📈 Data analysis and insights
🎪 Event planning and collaboration tools
🛠️ Technical applications and automation
Quick examples:
// Search for songs
{"tool": "searchSongs", "arguments": {"streamerName": "belleune", "query": "Frank Sinatra"}}
// Get most popular songs
{"tool": "getSongs", "arguments": {"streamerName": "belleune", "limit": 20}}
// Compare streamer libraries
{"tool": "getSongs", "arguments": {"streamerName": "vu_vu", "limit": 50}}API Status
Working Endpoints: All 6 tools use real API data
Streamer information, queue management, and full song library access
No authentication required for public endpoints
All features fully functional with real StreamerSongList API data
#Please be considerate when using streamersonglists api. It's a shared but limitted resource, be mindful when using LLM's to access it, Please don't ruin it for everyone!
For detailed API testing results, see docs/API_TESTING_REPORT.md
Environment
Optionally set a default streamer used when streamerName is omitted:
{
"mcpServers": {
"streamersonglist": {
"command": "npx",
"args": ["streamersonglist-mcp"],
"env": { "DEFAULT_STREAMER": "public_streamer" }
}
}
}CLI override examples:
DEFAULT_STREAMER=public_streamer npx streamersonglist-mcp
npx streamersonglist-mcp --streamer public_streamerConfiguration options:
DEFAULT_STREAMER— default streamer when an argument is omittedSSL_API_BASE— override API base (defaulthttps://api.streamersonglist.com/v1)
Version info: The server reports its version from package.json, matching the published package.
Security tip: use only public streamer names; the server calls public read-only endpoints.
Scripts
npm install— install dependenciesnpm start— run server on stdionpm test— spawn server and verify tools/listnpm run setup— generate Claude Desktop entries
License
MIT — see LICENSE.
Contributing
Contributions are welcome via pull requests. Due to limitations of the public StreamerSongList API, scope for major new features is intentionally modest — helpful contributions include:
Bug fixes, error handling, and robustness improvements
Documentation updates and examples
Small tooling or DX enhancements (tests, CI, config)
Please open an issue to discuss larger ideas before starting work, and run npm test before submitting PRs.
Credits
This project builds on the excellent StreamerSonglist service. All data and API functionality are provided by StreamerSonglist:
I am not affiliated with or endorsed by StreamerSonglist so please don't bother them with any issues you find in my code. Thankyou Streamersonglist for providing such a useful service to the streamer community. Very POG
Available Tools
6 toolsgetQueueB
View current song queues with pagination support
Inputs: streamerName, limit, offset.
getSongDetailsC
Get detailed information about a specific song by ID
Inputs: songId (required), streamerName.
getSongsA
Fetch the complete song list for a streamer with pagination support
Inputs: streamerName, limit, offset.
getStreamerByNameB
Fetch detailed information about a specific streamer
Inputs: streamerName.
monitorQueueB
Monitor queue changes with configurable polling intervals
Inputs: streamerName, interval, duration.
searchSongsB
Search within a streamer's song list by title or artist
Inputs: query (required), streamerName, limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool targets a distinct operation: queue viewing, song details, song list, streamer info, queue monitoring, and song search. No overlap exists.
All tools use camelCase with a verb_noun pattern (getQueue, getSongDetails, etc.), and the verbs are consistent (get, monitor, search).
Six tools cover the core functionalities of a song queue server without being excessive or insufficient.
The tool set fully covers the read-only domain: queue, song details, full list, search, streamer info, and monitoring. No obvious gaps for its purpose.
Maintenance
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
A Model Context Protocol server for Wix AI tools
MCP server that lets your AI assistant build and deploy apps, hosting each one at a live URL.
MCP server for RiverScript, an AI transcription platform - fetches transcripts shared via a link.
Related MCP Servers
- AlicenseBqualityCmaintenanceA lightweight Model Context Protocol server that enables AI assistants like Cursor & Claude to control Spotify playback and manage playlists.22508MIT
- FlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables controlling Spotify playback through natural language commands in MCP clients like Cursor or Claude for Desktop.1-
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables AI assistants like Claude to interact with Spotify, allowing them to search for tracks, control playback, and manage playlists.1ISC
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables AI assistants like Claude to generate lyrics, songs, and background music through Mureka's APIs.73 PyPI123MIT