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