About starsinger-mcp
starsinger-mcp connects AI agents to StarSinger’s catalog of AI-generated music. It supports natural-language searches, track details and streaming links, trending tracks, and artist browsing.
Key features
- 01Search by query, mood, or genre
- 02Get track details and streaming URLs
- 03Browse trending tracks
- 04Browse artists and discographies
- 05Track lyrics, artwork, and metadata
Use cases
- 01Find music for a mood or genre
- 02Retrieve a track link for playback
- 03Explore artists and their discographies
MCP support
Exposes StarSinger catalog search, track and artist lookup, trending tracks, and browsing tools to MCP clients. Access requires a StarSinger API key.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y starsinger-mcpSTARSINGER_API_KEYSecretYour StarSinger API key from https://mcp.starsinger.aiSTARSINGER_API_URLOptional: Custom API base URL (default: https://mcp-api.starsinger.ai)Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEStarSinger 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
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.