# AceDataCloud/MCPSuno [Health: Active]

**Category:** 🎥 Multimedia Process  
**Repository:** https://github.com/AceDataCloud/SunoMCP  
**GitHub Stars:** 49  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/acedatacloud-mcpsuno

## Description
Suno AI music generation, lyrics, covers, and vocal extraction via Ace Data Cloud API.

## Tools
Capabilities this server exposes over MCP:

- **suno_generate_music** — Generate AI music from a text prompt using Suno's Inspiration Mode.
- **suno_generate_custom_music** — Generate AI music with full control over lyrics, title, and style (Custom Mode).
- **suno_extend_music** — Extend an existing song from a specific timestamp with new lyrics.
- **suno_cover_music** — Create a cover or remix version of an existing song in a different style.
- **suno_concat_music** — Concatenate extended song segments into a single complete audio file.
- **suno_generate_with_persona** — Generate music using a saved artist persona for consistent vocal style.
- **suno_remaster_music** — Remaster an existing song; v5/v5.5 require a variation category.
- **suno_stems_music** — Separate a song into individual stems (vocals and instruments).
- **suno_replace_section** — Replace a specific time range in a song with new generated content.
- **suno_upload_extend** — Extend an uploaded audio (your own music) with new AI-generated content.
- **suno_upload_cover** — Create an AI cover of an uploaded audio (your own music).
- **suno_mashup_music** — Blend exactly two songs using a required creative-direction prompt.
- **suno_all_stems_music** — Return two distinct 12-stem candidate sets, labeled `stem_set` 1 and 2 in task results.
- **suno_generate_lyrics** — Generate song lyrics from a text prompt.
- **suno_get_mp4** — Get an MP4 video version of a generated song.
- **suno_get_timing** — Get timing and subtitle data for a generated song.
- **suno_extract_vocals** — Extract a required vocal interval shorter than 30 seconds.
- **suno_get_wav** — Get the lossless WAV format of a generated song.
- **suno_get_mp3** — Get the compressed MP3 format of a generated song.
- **suno_get_midi** — Get MIDI data extracted from a generated song.
- **suno_create_persona** — Create a new artist persona from an existing audio's vocal style.
- **suno_create_custom_model** — Create a reusable custom music model from 6 to 24 authorized audio URLs.
- **suno_get_custom_model** — Retrieve one custom music model by ID.
- **suno_list_custom_models** — List custom music models for the current Suno application.
- **suno_generate_with_custom_model** — Generate a song using a ready custom music model.
- **suno_delete_custom_model** — Archive a custom music model so it can no longer be used.
- **suno_optimize_style** — Optimize a music style description for better generation results.
- **suno_mashup_lyrics** — Generate mashup lyrics by combining two sets of lyrics.
- **suno_upload_audio** — Upload external audio in standard or enhanced mode for subsequent operations.
- **suno_get_task** — Query the status and result of a music generation task.
- **suno_get_tasks_batch** — Query multiple music generation tasks at once.
- **suno_list_models** — List all available Suno models and their capabilities.
- **suno_list_actions** — List all available Suno API actions and corresponding tools.
- **suno_get_lyric_format_guide** — Get guidance on formatting lyrics for Suno music generation.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

```json
"mcpServers": {
  "mcpsuno": {
    "command": "uvx",
    "args": ["mcp-suno"]
  }
}
```

## Documentation

## What AceDataCloud/MCPSuno MCP server does

AceDataCloud/MCPSuno MCP server connects MCP-compatible clients to Suno through the Ace Data Cloud API. It provides tools for creating songs from descriptions, specifying lyrics and style, extending existing tracks, producing covers, and replacing sections of audio. It also supports lyric generation and style optimization for preparing inputs to music-generation workflows.

The server covers post-generation operations as well. Generated or uploaded audio can be converted to MP3, WAV, MP4, or MIDI, and timing and subtitle data can be retrieved. Audio analysis and editing functions include vocal extraction, stem separation, concatenation of extended segments, remastering, and mashups.

## How it works

Requests are sent through MCP to the hosted Suno endpoint at `https://suno.mcp.acedata.cloud/mcp`. The server forwards operations to the Ace Data Cloud API and returns task information or generated results. Longer-running music operations can be monitored with `suno_get_task` or checked in batches with `suno_get_tasks_batch`.

Audio can be supplied by uploading it with `suno_upload_audio`, after which upload-based extension and cover tools can use it. Artist personas can be created from an existing vocal style and reused for later generation. The README also documents app-owned custom music models: clients can create, inspect, list, use, and archive those models.

## Setup and configuration

The documented hosted configuration uses an Ace Data Cloud API token as a bearer token in the MCP connection headers. Claude Desktop, Cursor, Windsurf, and Cline examples all point to the same streamable HTTP endpoint. Claude.ai has a separate OAuth connection flow, so it can be connected without manually entering an API token.

For Claude Code, the README provides an HTTP transport command using the hosted endpoint and an `Authorization: Bearer` header. The API token is obtained from the Ace Data Cloud platform after signing up and acquiring access to the Suno API documentation. The health endpoint does not require authentication, while MCP requests do.

## Tools and capabilities

AceDataCloud/MCPSuno MCP server includes tools for:

- Inspiration-mode and custom-mode song generation.
- Lyrics generation, mashup lyric creation, lyric-format guidance, and style optimization.
- Song extension, section replacement, remastering, covers, uploads, and two-song mashups.
- Persona creation and persona-based generation.
- Custom music model creation from 6–24 authorized audio URLs, model lookup, listing, generation, and archiving.
- Vocal extraction, standard stem separation, two candidate sets of 12 stems, and concatenation of song segments.
- MP3, WAV, MP4, MIDI, timing, subtitle, task-status, model-listing, and action-listing retrieval.

## Limitations and notes

Some operations have specific input constraints. `suno_mashup_music` accepts exactly two songs and requires a creative-direction prompt. `suno_extract_vocals` requires a vocal interval shorter than 30 seconds. Remastering with Suno v5 or v5.5 requires a variation category. Custom model creation requires between 6 and 24 authorized audio URLs.

The service depends on Ace Data Cloud access and Suno API availability. The provided setup material documents a hosted MCP server rather than a local package installation. Generated work is exposed as task results, so clients should be prepared to poll task status before attempting to retrieve or process outputs.

_Full upstream README: https://allmcps.com/mcp/acedatacloud-mcpsuno/readme_