# Starsinger Mcp

> MCP server for the StarSinger AI music catalog — search, stream, and browse AI-generated tracks via Model Context Protocol

- **Type:** MCP server
- **Install:** `agentstack add mcp-starsinger-ai-starsinger-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [starsinger-ai](https://agentstack.voostack.com/s/starsinger-ai)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [starsinger-ai](https://github.com/starsinger-ai)
- **Source:** https://github.com/starsinger-ai/starsinger-mcp
- **Website:** https://mcp.starsinger.ai

## Install

```sh
agentstack add mcp-starsinger-ai-starsinger-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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](https://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`:

```json
{
  "mcpServers": {
    "starsinger": {
      "command": "npx",
      "args": ["-y", "starsinger-mcp"],
      "env": {
        "STARSINGER_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

**Cursor** — add to `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "starsinger": {
      "command": "npx",
      "args": ["-y", "starsinger-mcp"],
      "env": {
        "STARSINGER_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

**VS Code** — add to user settings:

```json
{
  "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](https://starsinger.ai) 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

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [starsinger-ai](https://github.com/starsinger-ai)
- **Source:** [starsinger-ai/starsinger-mcp](https://github.com/starsinger-ai/starsinger-mcp)
- **License:** MIT
- **Homepage:** https://mcp.starsinger.ai

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-starsinger-ai-starsinger-mcp
- Seller: https://agentstack.voostack.com/s/starsinger-ai
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.