io.github.starsinger-ai/starsinger-mcp
MCP server for StarSinger AI music catalog — search, stream & browse AI-generated tracks
Open source Open in the app JSON README (API)
About
MCP server for StarSinger AI music catalog — search, stream & browse AI-generated tracks
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- starsinger-ai
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.1.1
- Stars
- 1
- Last push
- 2026-03-30T20:39:24Z
- Repository state
- ativo
- Language
- JavaScript
- License
- MIT
- Added
- 2026-08-29 04:01:27
- Updated
- 2026-08-29 04:01:27
- Origin id
io.github.starsinger-ai/starsinger-mcp
README
# 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