Suno MCP Integration Guide

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:

Register or log in to the AceData Cloud platform
Go to the Suno Audios API page
Click “Acquire” to get the API Token (first-time applicants receive free credits)

Installation Configuration

Method 1: pip Installation (Recommended)

pip install mcp-suno

Method 2: Source Installation

git clone https://github.com/AceDataCloud/SunoMCP.git
cd SunoMCP
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 Name	Description
`suno_generate_music`	Generate music through text prompts
`suno_generate_custom_music`	Generate music with custom lyrics and style
`suno_extend_music`	Continue a song from a specified time point
`suno_cover_music`	Create a cover version
`suno_concat_music`	Concatenate song segments
`suno_generate_with_persona`	Generate music using a specified vocal persona
`suno_remaster_music`	Remaster the audio
`suno_stems_music`	Separate tracks (vocals/accompaniment)
`suno_replace_section`	Replace specified sections in a song
`suno_upload_extend`	Upload audio and continue writing
`suno_upload_cover`	Upload audio and cover
`suno_mashup_music`	Mash up multiple songs
`suno_generate_lyrics`	Generate lyrics based on descriptions
`suno_create_persona`	Create a vocal persona
`suno_get_mp4`	Get song MP4 video
`suno_get_timing`	Get lyrics timing
`suno_extract_vocals`	Extract vocals
`suno_get_wav`	Get high-quality WAV
`suno_get_midi`	Get MIDI file
`suno_optimize_style`	Optimize music style tags
`suno_mashup_lyrics`	Mash up lyrics
`suno_upload_audio`	Upload custom audio
`suno_get_task`	Query the status of a single task
`suno_get_tasks_batch`	Batch 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

GitHub Repository: AceDataCloud/SunoMCP
PyPI Package: mcp-suno
API Documentation: Suno Music Generation API

​Feature Overview

​Prerequisites

​Installation Configuration

​Method 1: pip Installation (Recommended)

​Method 2: Source Installation

​Using in Claude Desktop

​Using in VS Code / Cursor

​Available Tools List

​Usage Examples

​More Information