StreamerSongList provides read-only access to the StreamerSongList platform used by live streamers to manage viewer song requests. It enables AI assistants to monitor music queues, search streamer libraries, and retrieve channel configurations without requiring authentication. Key capabilities: - Fetch streamer profiles and configuration settings by channel name - View current song request queues with statistics and pagination support - Browse complete song libraries and search by title or artist - Retrieve detailed metadata for specific tracks including request status - Monitor live queue changes and real-time updates

StreamerSongList MCP Server

[](https://smithery.ai/server/@vuvuvu/streamersonglist-mcp) [](https://github.com/vuvuvu/streamersonglist-mcp/actions/workflows/test.yml) [](https://opensource.org/licenses/MIT) [](https://nodejs.org/)

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

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

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:

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)

Usage Examples

For comprehensive examples of how to use these tools, see docs/USAGE_EXAMPLES.md including:

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

#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:

Version info: The server reports its version from package.json, matching the published package.

Security tip: use only public streamer names; the server calls pu