starsinger mcp

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