Skip to main content
MCP (Model Context Protocol) is a model context protocol launched by Anthropic that allows AI models (such as Claude, GPT, etc.) to call external tools through standardized interfaces. With the Suno MCP Server provided by AceData Cloud, you can directly generate music, lyrics, and manage audio projects in AI clients like Claude Desktop, VS Code, Cursor, etc.

​
Feature Overview

The Suno MCP Server provides the following core functionalities:
  • Music Generation — Generate AI music through text prompts
  • Custom Creation — Full control over lyrics, titles, and music styles
  • Song Continuation — Extend existing songs from any point in time
  • Cover/Remix — Create cover versions in different styles
  • Lyric Generation — Generate structured lyrics based on descriptions
  • Vocal Persona — Save and reuse vocal styles
  • Media Conversion — Obtain MP4, WAV, MIDI, vocal separation, etc.
  • Style Optimization — Optimize music style tags
  • Task Query — Monitor generation progress and obtain results

​
Prerequisites

Before using, you need to obtain an AceData Cloud API Token:
  1. Register or log in to the AceData Cloud platform
  2. Go to the Suno Audios API page
  3. Click “Acquire” to get the API Token (first-time applicants receive free credits)

​
Installation Configuration

pip install mcp-suno

​
Method 2: Source Installation

git clone https://github.com/AceDataCloud/MCPSuno.git
cd MCPSuno
pip install -e .
Once installed, you can use the mcp-suno command to start the service.

​
Using in Claude Desktop

Edit the Claude Desktop configuration file:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
Add the following configuration: 
{
  "mcpServers": {
    "suno": {
      "command": "mcp-suno",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "your API Token"
      }
    }
  }
}
If using uvx (no need to install the package in advance): 
{
  "mcpServers": {
    "suno": {
      "command": "uvx",
      "args": ["mcp-suno"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "your API Token"
      }
    }
  }
}
After saving the configuration, restart Claude Desktop to use Suno-related tools in conversations.

​
Using in VS Code / Cursor

Create a .vscode/mcp.json in the project root directory: 
{
  "servers": {
    "suno": {
      "command": "mcp-suno",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "your API Token"
      }
    }
  }
}
Or use uvx: 
{
  "servers": {
    "suno": {
      "command": "uvx",
      "args": ["mcp-suno"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "your API Token"
      }
    }
  }
}

​
Available Tools List

Tool NameDescription
suno_generate_musicGenerate music through text prompts
suno_generate_custom_musicGenerate music with custom lyrics and style
suno_extend_musicContinue a song from a specified time point
suno_cover_musicCreate a cover version
suno_concat_musicConcatenate song segments
suno_generate_with_personaGenerate music using a specified vocal persona
suno_remaster_musicRemaster the audio
suno_stems_musicSeparate tracks (vocals/accompaniment)
suno_replace_sectionReplace specified sections in a song
suno_upload_extendUpload audio and continue writing
suno_upload_coverUpload audio and cover
suno_mashup_musicMash up multiple songs
suno_generate_lyricsGenerate lyrics based on descriptions
suno_create_personaCreate a vocal persona
suno_get_mp4Get song MP4 video
suno_get_timingGet lyrics timing
suno_extract_vocalsExtract vocals
suno_get_wavGet high-quality WAV
suno_get_midiGet MIDI file
suno_optimize_styleOptimize music style tags
suno_mashup_lyricsMash up lyrics
suno_upload_audioUpload custom audio
suno_get_taskQuery the status of a single task
suno_get_tasks_batchBatch query task statuses

​
Usage Examples

After configuration, you can directly call these functions in AI clients using natural language, for example:
  • “Help me generate a pop song about summer”
  • “Cover this song in jazz style”
  • “Continue this song from the 30-second mark”
  • “Generate a Chinese lyric with the theme of travel”
  • “Separate the vocals from this song”
  • “Help me convert this song to MIDI format”

​
More Information