What can you do with this 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.

Which integrations are available for this server?

Includes [GitHub](/mcp/servers/integrations/github) Actions for testing the MCP server, indicated by the test workflow badge Built on [Node.js](/mcp/servers/integrations/node-dot-js) runtime (version 18+) to enable interactions with StreamerSongList APIs Compatible with [OpenAI](/mcp/servers/integrations/openai) agents through the MCP protocol for managing song requests and monitoring queues

StreamerSongList MCP Server

Test MCP Server License: MIT Node.js Version

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 claude

Related MCP server: Vulpes 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:

🚀 Deploy to Smithery.ai

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.js

Alternative (raw stdio):

npm start printf '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}\n' | node src/server.js

Available 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_streamer

Configuration options:

DEFAULT_STREAMER — default streamer when an argument is omitted
SSL_API_BASE — override API base (default https://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 dependencies
npm start — run server on stdio
npm test — spawn server and verify tools/list
npm 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:

https://www.streamersonglist.com

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