io.github.starsinger-ai/starsinger-mcp
MCP server for StarSinger AI music catalog β search, stream & browse AI-generated tracks
Ask AI about io.github.starsinger-ai/starsinger-mcp
Powered by Claude Β· Grounded in docs
I know everything about io.github.starsinger-ai/starsinger-mcp. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
StarSinger MCP Server
An MCP (Model Context Protocol) server that gives AI agents access to the StarSinger AI music catalog β search, stream, and browse tracks from a growing library of AI-generated music.
Quick Start
1. Get an API Key
Get a free API key at mcp.starsinger.ai β sign up and create a key from the dashboard.
2. Add to Your AI Tool
Claude Desktop β add to claude_desktop_config.json:
{
"mcpServers": {
"starsinger": {
"command": "npx",
"args": ["-y", "starsinger-mcp"],
"env": {
"STARSINGER_API_KEY": "your_api_key_here"
}
}
}
}
Cursor β add to .cursor/mcp.json:
{
"mcpServers": {
"starsinger": {
"command": "npx",
"args": ["-y", "starsinger-mcp"],
"env": {
"STARSINGER_API_KEY": "your_api_key_here"
}
}
}
}
VS Code β add to user settings:
{
"mcp": {
"servers": {
"starsinger": {
"command": "npx",
"args": ["-y", "starsinger-mcp"],
"env": {
"STARSINGER_API_KEY": "your_api_key_here"
}
}
}
}
}
3. Try It
Ask your AI assistant:
"Find me some chill jazz piano tracks"
"What artists does StarSinger have?"
"Get me an upbeat track for a workout video"
Tools
search_music
Search the catalog by natural language query, mood, or genre.
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Natural language search β "upbeat jazz piano", "sad violin ballad" |
mood | string | No | Filter by mood: purple (chill), red (energetic), blue (emotional), gold (uplifting), green (nature), pink (romantic), dark (intense), rainbow (eclectic) |
limit | number | No | Results to return (default 10, max 50) |
get_track
Get full details and streaming URL for a specific track.
| Parameter | Type | Required | Description |
|---|---|---|---|
trackId | string | Yes | Track ID from search results |
get_trending
Get currently popular tracks from the catalog.
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | number | No | Number of tracks (default 10, max 50) |
browse_artists
Browse AI catalog artists, optionally filtered by genre.
| Parameter | Type | Required | Description |
|---|---|---|---|
genre | string | No | Filter by genre (e.g. "jazz", "classical", "pop") |
limit | number | No | Number of artists (default 10, max 50) |
get_artist
Get an artist's full profile and discography.
| Parameter | Type | Required | Description |
|---|---|---|---|
artistId | string | No | Artist ID from browse results |
handle | string | No | Artist handle (e.g. "miles_rivers") |
What You Get
Every track response includes:
- Streaming URL β Direct MP3 link, ready to play or embed
- Cover art β Album artwork URL
- Full lyrics β Complete song lyrics
- Metadata β Title, artist, genre, mood, play count, likes
- Artist info β Bio, influences, instrument, city
Configuration
| Environment Variable | Required | Default | Description |
|---|---|---|---|
STARSINGER_API_KEY | Yes | β | Your StarSinger API key |
STARSINGER_API_URL | No | https://mcp-api.starsinger.ai | API base URL |
About StarSinger
StarSinger is an AI music creation platform. All music in the catalog is AI-generated and owned by Veronata Inc., available for use via this API.
License
MIT
