# Suno by Ace Data Cloud

Wires Suno into your AI client: generate songs and lyrics, make covers, split stems and track tasks from chat.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 69
- Author: AceDataCloud
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/AceDataCloud/SunoMCP
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/mcp/suno-by-ace-data-cloud

## What it does

The server exposes Suno through the Ace Data Cloud API. From chat you can build a song from a text prompt, set your own lyrics, title and style, extend a track from a given timestamp, or make a cover and remix. Separate tools pull vocals, split a song into stems, and return WAV, MP3, MIDI and MP4 plus timing and subtitle data.

There are more than thirty tools inside: `suno_generate_music`, `suno_generate_custom_music`, `suno_extend_music`, `suno_cover_music`, `suno_concat_music`, `suno_generate_lyrics`, `suno_stems_music`, `suno_get_task` and others. Personas and custom models are covered, along with uploading your own audio to extend or cover, and mashups of two tracks. Generation is asynchronous, so keep the original task ID — that is what you use later with `suno_get_task` or `suno_get_tasks_batch` to collect the result.

Two connection routes exist. Browser sign-in over OAuth keeps the key out of your MCP config; an API token is for clients that cannot complete remote OAuth. Generation spends your Ace account balance, so without a token or an approved sign-in the tools will not run. The hosted server lives at `https://suno.mcp.acedata.cloud/mcp`.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Remote server: `https://suno.mcp.acedata.cloud/mcp`
- Environment variables: `ACEDATACLOUD_API_TOKEN` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http mcp-suno https://suno.mcp.acedata.cloud/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env ACEDATACLOUD_API_TOKEN=<ACEDATACLOUD_API_TOKEN> --transport stdio suno-by-ace-data-cloud -- uvx mcp-suno
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-suno <command>

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add suno-by-ace-data-cloud --url https://suno.mcp.acedata.cloud/mcp
```

2. **Platform CLI**
```bash
codex mcp add suno-by-ace-data-cloud --env ACEDATACLOUD_API_TOKEN=<ACEDATACLOUD_API_TOKEN> -- uvx mcp-suno
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-suno <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "suno-by-ace-data-cloud": {
            "url": "https://suno.mcp.acedata.cloud/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "suno-by-ace-data-cloud": {
            "command": "uvx",
            "args": [
                "mcp-suno"
            ],
            "env": {
                "ACEDATACLOUD_API_TOKEN": "<ACEDATACLOUD_API_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-suno <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "suno-by-ace-data-cloud": {
            "type": "http",
            "url": "https://suno.mcp.acedata.cloud/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "suno-by-ace-data-cloud": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "mcp-suno"
            ],
            "env": {
                "ACEDATACLOUD_API_TOKEN": "<ACEDATACLOUD_API_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-suno <command>

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http suno-by-ace-data-cloud https://suno.mcp.acedata.cloud/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e ACEDATACLOUD_API_TOKEN=<ACEDATACLOUD_API_TOKEN> suno-by-ace-data-cloud uvx mcp-suno
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-suno <command>

## When to use it
- generate a song from a text prompt
- set your own lyrics, title and style
- extend an existing song from a timestamp
- make a cover or remix in another style
- separate a track into vocals and instruments

## Example prompts
- Generate a synthwave song about a night city
- Make a jazz cover of this track
- Split the song into stems and show me the result

## Similar
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16717
- [labelhead-artist-momentum](https://affpapa.org/en/nevibecode/mcp/labelhead-artist-momentum.md) — MCP server · ★ 107423
- [Agent Skills Search Server](https://affpapa.org/en/nevibecode/mcp/agent-skills-search-server.md) — MCP server · ★ 26559
- [Skyvern](https://affpapa.org/en/nevibecode/mcp/skyvern.md) — MCP server · ★ 23263
- [Nhost](https://affpapa.org/en/nevibecode/mcp/nhost.md) — MCP server · ★ 9366
- [PraisonAI](https://affpapa.org/en/nevibecode/mcp/praisonai.md) — MCP server · ★ 9289

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md