Summary
Connects Claude directly to Suno's AI music generation platform through the AceDataCloud API. You get 24 tools covering the full creative workflow: generate songs from prompts or custom lyrics, extend tracks from specific timestamps, create covers and remixes, separate stems, extract vocals, and manage artist personas for consistent voice styles. Also handles practical tasks like concatenating extended segments, optimizing style descriptions, and tracking generation progress. Works through a hosted endpoint at suno.mcp.acedata.cloud, so no local setup required. Just grab an API token from AceDataCloud's platform and add the config to Claude Desktop, Cursor, VS Code, or whichever MCP client you're using. Useful if you're building music workflows, prototyping audio features, or just want to generate and manipulate AI music without leaving your development environment.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Tools
Public tool metadata for what this MCP can expose to an agent.
27 tools
suno_generate_musicGenerate AI music from a text prompt using Suno's Inspiration Mode. This is the simplest way to create music - just describe what you want and Suno will automatically generate appropriate lyrics, melody, style, and arrangement. Use this when: - You want quick music generation...4 params
Generate AI music from a text prompt using Suno's Inspiration Mode. This is the simplest way to create music - just describe what you want and Suno will automatically generate appropriate lyrics, melody, style, and arrangement. Use this when: - You want quick music generation...
Parameters* required
modelstringSuno model version. 'chirp-v4-5' is recommended for most use cases. 'chirp-v5' offers best quality with 8-minute max duration. Older models (v3, v3-5, v4) have shorter duration limits.one of
chirp-v3-0 · chirp-v3-5 · chirp-v4 · chirp-v4-5 · chirp-v4-5-plus · chirp-v5default: chirp-v4-5promptstringDescription of the music to generate. Be descriptive about genre, mood, instruments, and theme. Examples: 'A happy birthday song with acoustic guitar', 'Epic orchestral battle music with dramatic choir', 'Chill lo-fi hip hop beat for studying'
callback_urlvalueWebhook callback URL for asynchronous notifications. When provided, the API will call this URL when the audio is generated.
instrumentalbooleanIf true, generate instrumental music without vocals. Default is false (with vocals).default: false
suno_generate_custom_musicGenerate AI music with full control over lyrics, title, and style (Custom Mode). This gives you complete creative control over the song. You provide the lyrics with section markers, and Suno generates the melody and arrangement. Use this when: - You have specific lyrics you wa...8 params
Generate AI music with full control over lyrics, title, and style (Custom Mode). This gives you complete creative control over the song. You provide the lyrics with section markers, and Suno generates the melody and arrangement. Use this when: - You have specific lyrics you wa...
Parameters* required
lyricstringSong lyrics with section markers. Use [Verse], [Chorus], [Pre-Chorus], [Bridge], [Outro], [Intro] to structure the song. Example:
[Verse 1]
Walking down the empty street
Rain is falling at my feet
[Chorus]
But I keep moving on
Until the break of dawn
modelstringSuno model version. 'chirp-v4-5' or 'chirp-v5' recommended for best quality.one of
chirp-v3-0 · chirp-v3-5 · chirp-v4 · chirp-v4-5 · chirp-v4-5-plus · chirp-v5default: chirp-v4-5stylestringMusic style description. Be specific about genre, mood, tempo, and instruments. Examples: 'upbeat pop rock, energetic drums, electric guitar', 'acoustic folk, gentle, fingerpicking', 'dark electronic, synthwave, 80s retro'default:
titlestringTitle of the song. Keep it concise and memorable.
callback_urlvalueWebhook callback URL for asynchronous notifications. When provided, the API will call this URL when the audio is generated.
instrumentalbooleanIf true, generate instrumental version (lyrics will be ignored). Default is false.default: false
vocal_genderstringPreferred vocal gender. 'f' for female, 'm' for male, empty string for AI to decide. Only works with v4.5+ models.one of
· f · mdefault: style_negativestringStyles to explicitly exclude from the generation. Examples: 'heavy metal, screaming', 'autotune, electronic'default:
suno_extend_musicExtend an existing song from a specific timestamp with new lyrics. This allows you to continue a previously generated song, adding new sections like additional verses, a bridge, or an outro. Use this when: - A generated song is too short and you want to add more - You want to...6 params
Extend an existing song from a specific timestamp with new lyrics. This allows you to continue a previously generated song, adding new sections like additional verses, a bridge, or an outro. Use this when: - A generated song is too short and you want to add more - You want to...
Parameters* required
lyricstringLyrics for the extended section. Use section markers like [Verse], [Chorus], [Bridge], [Outro]. The extension will continue from where the original song left off.
modelstringModel version to use for the extension.one of
chirp-v3-0 · chirp-v3-5 · chirp-v4 · chirp-v4-5 · chirp-v4-5-plus · chirp-v5default: chirp-v4-5stylestringMusic style for the extension. Leave empty to maintain the original style, or specify to change the style mid-song.default:
audio_idstringID of the audio to extend. This is the 'id' field from a previous generation result.
continue_atnumberTimestamp in seconds where to start the extension. For example, 120.5 means continue from 2 minutes and 0.5 seconds into the song.
callback_urlvalueWebhook callback URL for asynchronous notifications. When provided, the API will call this URL when the extension is complete.
suno_cover_musicCreate a cover or remix version of an existing song in a different style. This generates a new version of a song with a different arrangement, genre, or mood while keeping the core melody and lyrics. Use this when: - You want to hear a song in a different genre - You want an a...5 params
Create a cover or remix version of an existing song in a different style. This generates a new version of a song with a different arrangement, genre, or mood while keeping the core melody and lyrics. Use this when: - You want to hear a song in a different genre - You want an a...
Parameters* required
modelstringModel version to use for the cover.one of
chirp-v3-0 · chirp-v3-5 · chirp-v4 · chirp-v4-5 · chirp-v4-5-plus · chirp-v5default: chirp-v4-5stylestringTarget music style for the cover. Examples: 'jazz, smooth, saxophone', 'acoustic folk, gentle guitar', 'electronic dance, high energy'default:
promptstringDescription of how you want the cover to sound. Examples: 'acoustic unplugged version', 'jazz lounge style', '80s synthwave remix'default:
audio_idstringID of the audio to create a cover of. This is the 'id' field from a previous generation.
callback_urlvalueWebhook callback URL for asynchronous notifications. When provided, the API will call this URL when the cover is complete.
suno_concat_musicConcatenate extended song segments into a single complete audio file. After extending a song multiple times with suno_extend_music, use this tool to merge all the segments into one continuous audio file. Use this when: - You've extended a song one or more times - You want a si...2 params
Concatenate extended song segments into a single complete audio file. After extending a song multiple times with suno_extend_music, use this tool to merge all the segments into one continuous audio file. Use this when: - You've extended a song one or more times - You want a si...
Parameters* required
audio_idstringID of the LAST segment of an extended song chain. Suno will automatically find and merge all connected segments.
callback_urlvalueWebhook callback URL for asynchronous notifications. When provided, the API will call this URL when the concatenation is complete.
suno_generate_with_personaGenerate music using a saved artist persona for consistent vocal style. This allows you to maintain a consistent voice/singing style across multiple songs by using a previously saved persona. Use this when: - You want multiple songs with the same vocal style - You're creating...5 params
Generate music using a saved artist persona for consistent vocal style. This allows you to maintain a consistent voice/singing style across multiple songs by using a previously saved persona. Use this when: - You want multiple songs with the same vocal style - You're creating...
Parameters* required
modelstringModel version to use.one of
chirp-v3-0 · chirp-v3-5 · chirp-v4 · chirp-v4-5 · chirp-v4-5-plus · chirp-v5default: chirp-v4-5promptstringDescription of the music to generate. The persona's voice will be applied to this new song.
audio_idstringID of a reference audio to base the generation on.
persona_idstringID of the persona to use. Get this from suno_create_persona tool. The persona defines the vocal style and characteristics.
callback_urlvalueWebhook callback URL for asynchronous notifications. When provided, the API will call this URL when the audio is generated.
suno_remaster_musicRemaster an existing song to improve audio quality. Takes a previously generated song and applies audio remastering to enhance clarity, dynamics, and overall sound quality. Use this when: - You want to improve the audio quality of a generated song - You want a song generated w...3 params
Remaster an existing song to improve audio quality. Takes a previously generated song and applies audio remastering to enhance clarity, dynamics, and overall sound quality. Use this when: - You want to improve the audio quality of a generated song - You want a song generated w...
Parameters* required
modelstringModel version to use for remastering. Newer models produce better results.one of
chirp-v3-0 · chirp-v3-5 · chirp-v4 · chirp-v4-5 · chirp-v4-5-plus · chirp-v5default: chirp-v4-5audio_idstringID of the audio to remaster. This is the 'id' field from a previous generation.
callback_urlvalueWebhook callback URL for asynchronous notifications.
suno_stems_musicSeparate a song into individual stems (vocals and instruments). Splits the audio into separate tracks for vocals and instrumentals, useful for remixing, karaoke, or isolating specific parts. Use this when: - You want to separate vocals from instrumentals - You need individual...2 params
Separate a song into individual stems (vocals and instruments). Splits the audio into separate tracks for vocals and instrumentals, useful for remixing, karaoke, or isolating specific parts. Use this when: - You want to separate vocals from instrumentals - You need individual...
Parameters* required
audio_idstringID of the audio to separate into stems.
callback_urlvalueWebhook callback URL for asynchronous notifications.
suno_replace_sectionReplace a specific time range in a song with new generated content. Re-generates a portion of a song between the specified start and end times, keeping the rest of the song unchanged. Great for fixing sections you don't like. Use this when: - A specific section of a song needs...7 params
Replace a specific time range in a song with new generated content. Re-generates a portion of a song between the specified start and end times, keeping the rest of the song unchanged. Great for fixing sections you don't like. Use this when: - A specific section of a song needs...
Parameters* required
lyricvalueNew lyrics for the replaced section. Use section markers like [Verse], [Chorus].
modelstringModel version to use.one of
chirp-v3-0 · chirp-v3-5 · chirp-v4 · chirp-v4-5 · chirp-v4-5-plus · chirp-v5default: chirp-v4-5stylestringMusic style for the replaced section.default:
audio_idstringID of the audio to replace a section in.
callback_urlvalueWebhook callback URL for asynchronous notifications.
replace_section_endnumberEnd time in seconds of the section to replace.
replace_section_startnumberStart time in seconds of the section to replace.
suno_upload_extendExtend an uploaded audio (your own music) with new AI-generated content. Similar to suno_extend_music but works with audio you uploaded via suno_upload_audio. Allows you to add new sections to your own music. Use this when: - You uploaded your own music and want to extend it -...6 params
Extend an uploaded audio (your own music) with new AI-generated content. Similar to suno_extend_music but works with audio you uploaded via suno_upload_audio. Allows you to add new sections to your own music. Use this when: - You uploaded your own music and want to extend it -...
Parameters* required
lyricstringLyrics for the extension section.
modelstringModel version to use.one of
chirp-v3-0 · chirp-v3-5 · chirp-v4 · chirp-v4-5 · chirp-v4-5-plus · chirp-v5default: chirp-v4-5stylestringMusic style for the extension.default:
audio_idstringID of the uploaded audio to extend. Must be an audio uploaded via suno_upload_audio.
continue_atnumberTimestamp in seconds where to start the extension.
callback_urlvalueWebhook callback URL for asynchronous notifications.
suno_upload_coverCreate an AI cover of an uploaded audio (your own music). Similar to suno_cover_music but works with audio you uploaded via suno_upload_audio. Re-arranges your music in a different style. Use this when: - You uploaded your own music and want a cover in a different style - You...4 params
Create an AI cover of an uploaded audio (your own music). Similar to suno_cover_music but works with audio you uploaded via suno_upload_audio. Re-arranges your music in a different style. Use this when: - You uploaded your own music and want a cover in a different style - You...
Parameters* required
modelstringModel version to use.one of
chirp-v3-0 · chirp-v3-5 · chirp-v4 · chirp-v4-5 · chirp-v4-5-plus · chirp-v5default: chirp-v4-5stylestringTarget music style for the cover.default:
audio_idstringID of the uploaded audio to create a cover of. Must be an audio uploaded via suno_upload_audio.
callback_urlvalueWebhook callback URL for asynchronous notifications.
suno_mashup_musicCreate a musical mashup by blending multiple songs together. Combines elements from multiple generated songs into a single cohesive mashup track. Different from lyrics mashup - this blends the actual audio. Use this when: - You want to blend two or more songs together musicall...3 params
Create a musical mashup by blending multiple songs together. Combines elements from multiple generated songs into a single cohesive mashup track. Different from lyrics mashup - this blends the actual audio. Use this when: - You want to blend two or more songs together musicall...
Parameters* required
modelstringModel version to use.one of
chirp-v3-0 · chirp-v3-5 · chirp-v4 · chirp-v4-5 · chirp-v4-5-plus · chirp-v5default: chirp-v4-5callback_urlvalueWebhook callback URL for asynchronous notifications.
mashup_audio_idsarrayList of audio IDs to mashup together. Provide 2 or more song IDs.
suno_list_modelsList all available Suno models and their capabilities. Shows all available model versions with their limits, features, and recommended use cases. Use this to understand which model to choose for your music generation. Model comparison: - chirp-v5: Latest and best quality, 8-mi...
List all available Suno models and their capabilities. Shows all available model versions with their limits, features, and recommended use cases. Use this to understand which model to choose for your music generation. Model comparison: - chirp-v5: Latest and best quality, 8-mi...
No parameter schema in public metadata yet.
suno_list_actionsList all available Suno API actions and corresponding tools. Reference guide for what each action does and which tool to use. Helpful for understanding the full capabilities of the Suno MCP. Returns: Categorized list of all actions and their corresponding tools.
List all available Suno API actions and corresponding tools. Reference guide for what each action does and which tool to use. Helpful for understanding the full capabilities of the Suno MCP. Returns: Categorized list of all actions and their corresponding tools.
No parameter schema in public metadata yet.
suno_get_lyric_format_guideGet guidance on formatting lyrics for Suno music generation. Shows how to structure lyrics with section markers for best results. Following this format helps Suno understand the song structure and generate appropriate melodies for each section. Returns: Complete guide with sec...
Get guidance on formatting lyrics for Suno music generation. Shows how to structure lyrics with section markers for best results. Following this format helps Suno understand the song structure and generate appropriate melodies for each section. Returns: Complete guide with sec...
No parameter schema in public metadata yet.
suno_generate_lyricsGenerate song lyrics from a text prompt. Creates structured lyrics with proper song sections (Verse, Chorus, Bridge, etc.) based on your description. The generated lyrics are formatted and ready to use with suno_generate_custom_music. Use this when: - You need lyrics but don't...2 params
Generate song lyrics from a text prompt. Creates structured lyrics with proper song sections (Verse, Chorus, Bridge, etc.) based on your description. The generated lyrics are formatted and ready to use with suno_generate_custom_music. Use this when: - You need lyrics but don't...
Parameters* required
modelstringModel version for lyrics generation. 'default' works well for most lyrics. 'remi-v1' offers an alternative style.one of
default · remi-v1default: defaultpromptstringDescription of the lyrics you want. Include theme, mood, genre, and any specific elements. Examples: 'A romantic ballad about lost love and rainy nights', 'An upbeat pop song about summer vacation', 'A motivational hip-hop track about overcoming obstacles'
suno_get_mp4Get an MP4 video version of a generated song. Converts a generated audio into an MP4 video file with visualizations. Useful for sharing on social media or video platforms. Use this when: - You want a video version of a generated song - You need to share the song on video platf...1 params
Get an MP4 video version of a generated song. Converts a generated audio into an MP4 video file with visualizations. Useful for sharing on social media or video platforms. Use this when: - You want a video version of a generated song - You need to share the song on video platf...
Parameters* required
audio_idstringThe song ID to get the MP4 video for. This is the 'id' field from a previous audio generation result.
suno_get_timingGet timing and subtitle data for a generated song. Returns word-level timing information that can be used for synchronized lyrics display, karaoke, or subtitle generation. Use this when: - You need synchronized lyrics/subtitles - You want to create karaoke-style displays - You...1 params
Get timing and subtitle data for a generated song. Returns word-level timing information that can be used for synchronized lyrics display, karaoke, or subtitle generation. Use this when: - You need synchronized lyrics/subtitles - You want to create karaoke-style displays - You...
Parameters* required
audio_idstringThe song ID to get timing/subtitle data for.
suno_extract_vocalsExtract the vocal track from a generated song (stem separation). Isolates the vocals from a song, removing instrumental background. Useful for remixing, creating acapella versions, or persona creation. Use this when: - You want an isolated vocal track - You need vocals for a r...4 params
Extract the vocal track from a generated song (stem separation). Isolates the vocals from a song, removing instrumental background. Useful for remixing, creating acapella versions, or persona creation. Use this when: - You want an isolated vocal track - You need vocals for a r...
Parameters* required
audio_idstringThe song ID to extract vocals from.
vocal_endvalueEnd time in seconds for the vocal extraction range.
vocal_startvalueStart time in seconds for the vocal extraction range.
callback_urlvalueWebhook callback URL for asynchronous notifications.
suno_get_wavGet the lossless WAV format of a generated song. Converts the song to high-quality uncompressed WAV format. WAV files are larger but have no quality loss compared to MP3. Use this when: - You need a lossless audio format for production - You want the highest quality audio outp...2 params
Get the lossless WAV format of a generated song. Converts the song to high-quality uncompressed WAV format. WAV files are larger but have no quality loss compared to MP3. Use this when: - You need a lossless audio format for production - You want the highest quality audio outp...
Parameters* required
audio_idstringThe song ID to get the WAV format for.
callback_urlvalueWebhook callback URL for asynchronous notifications.
suno_get_midiGet MIDI data extracted from a generated song. Converts the song's melodic and rhythmic information into MIDI format, which can be used in digital audio workstations (DAWs) for further editing. Use this when: - You want to edit the melody in a DAW - You need note-level data fr...2 params
Get MIDI data extracted from a generated song. Converts the song's melodic and rhythmic information into MIDI format, which can be used in digital audio workstations (DAWs) for further editing. Use this when: - You want to edit the melody in a DAW - You need note-level data fr...
Parameters* required
audio_idstringThe song ID to get MIDI data for.
callback_urlvalueWebhook callback URL for asynchronous notifications.
suno_create_personaCreate a new artist persona from an existing audio's vocal style. This saves the vocal characteristics from a generated song so you can reuse that same voice style in future generations. Great for maintaining consistency across multiple songs. Use this when: - You generated a...6 params
Create a new artist persona from an existing audio's vocal style. This saves the vocal characteristics from a generated song so you can reuse that same voice style in future generations. Great for maintaining consistency across multiple songs. Use this when: - You generated a...
Parameters* required
namestringName for this persona. Use a descriptive name that helps you remember the voice style. Examples: 'My Rock Voice', 'Soft Female Singer', 'Deep Male Baritone', 'Energetic Pop Vocalist'
audio_idstringID of the audio to use as the persona reference. This should be a previously generated song whose vocal style you want to save and reuse.
vocal_endvalueEnd time in seconds of the vocal segment to use from the audio.
descriptionvalueDescription of the singer's style. Examples: 'Warm and breathy female voice with jazz influences', 'Powerful male rock vocalist with raspy tone'
vocal_startvalueStart time in seconds of the vocal segment to use from the audio. Useful for isolating a specific vocal section.
vox_audio_idvalueOptional audio ID used to generate a new singer's style by combining with the main audio. Useful for creating hybrid vocal personas.
suno_optimize_styleOptimize a music style description for better generation results. Takes a rough style description and refines it into an optimized style prompt that Suno can better understand and produce higher quality music for. Use this when: - You have a vague style idea and want to refine...1 params
Optimize a music style description for better generation results. Takes a rough style description and refines it into an optimized style prompt that Suno can better understand and produce higher quality music for. Use this when: - You have a vague style idea and want to refine...
Parameters* required
promptstringStyle prompt words that need to be optimized. Examples: 'rock guitar', 'jazz smooth', 'electronic dance party'
suno_mashup_lyricsGenerate mashup lyrics by combining two sets of lyrics. Takes two different song lyrics and intelligently combines them into a cohesive mashup. Great for creating unique lyrical combinations. Use this when: - You want to blend two songs' lyrics together - You're creating a mas...2 params
Generate mashup lyrics by combining two sets of lyrics. Takes two different song lyrics and intelligently combines them into a cohesive mashup. Great for creating unique lyrical combinations. Use this when: - You want to blend two songs' lyrics together - You're creating a mas...
Parameters* required
lyrics_astringThe first set of lyrics to combine. Can be full song lyrics with section markers.
lyrics_bstringThe second set of lyrics to combine. Can be full song lyrics with section markers.
suno_upload_audioUpload an external audio file to Suno for use in subsequent operations. Uploads audio from a URL so it can be used with actions like upload_extend and upload_cover, which allow you to extend or create covers of your own music. Use this when: - You have your own music you want...1 params
Upload an external audio file to Suno for use in subsequent operations. Uploads audio from a URL so it can be used with actions like upload_extend and upload_cover, which allow you to extend or create covers of your own music. Use this when: - You have your own music you want...
Parameters* required
audio_urlstringPublic URL of the audio file to upload. The URL must be directly accessible (CDN link, cloud storage URL, etc.).
suno_get_taskQuery the status and result of a music generation task. Use this to check if a generation is complete and retrieve the resulting audio URLs, titles, lyrics, and other metadata. Use this when: - You want to check if a generation has completed - You need to retrieve audio URLs f...1 params
Query the status and result of a music generation task. Use this to check if a generation is complete and retrieve the resulting audio URLs, titles, lyrics, and other metadata. Use this when: - You want to check if a generation has completed - You need to retrieve audio URLs f...
Parameters* required
task_idstringThe task ID returned from a generation request. This is the 'task_id' field from any suno_generate_*, suno_extend_*, suno_cover_*, or suno_concat_* tool response.
suno_get_tasks_batchQuery multiple music generation tasks at once. Efficiently check the status of multiple tasks in a single request. More efficient than calling suno_get_task multiple times. Use this when: - You have multiple pending generations to check - You want to get status of several song...1 params
Query multiple music generation tasks at once. Efficiently check the status of multiple tasks in a single request. More efficient than calling suno_get_task multiple times. Use this when: - You have multiple pending generations to check - You want to get status of several song...
Parameters* required
task_idsarrayList of task IDs to query. Maximum recommended batch size is 50 tasks.
SunoMCP
A Model Context Protocol (MCP) server for AI music generation using Suno through the AceDataCloud API.
Generate AI music, lyrics, and manage audio projects directly from Claude, VS Code, or any MCP-compatible client.
Features
- Music Generation - Create AI-generated songs from text prompts
- Custom Lyrics & Style - Full control over lyrics, title, and music style
- Song Extension - Continue existing songs from any timestamp
- Cover/Remix - Create cover versions with different styles
- Lyrics Generation - Generate structured lyrics from descriptions
- Persona Management - Save and reuse voice styles
- Task Tracking - Monitor generation progress and retrieve results
Tool Reference
| Tool | Description |
|---|---|
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 to improve audio quality. |
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 | Create a musical mashup by blending multiple songs together. |
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 the vocal track from a generated song (stem separation). |
suno_get_wav | Get the lossless WAV 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_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 an external audio file to Suno for use in 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. |
Quick Start
1. Get Your API Token
- Sign up at AceDataCloud Platform
- Go to the API documentation page
- Click "Acquire" to get your API token
- Copy the token for use below
2. Use the Hosted Server (Recommended)
AceDataCloud hosts a managed MCP server — no local installation required.
Endpoint: https://suno.mcp.acedata.cloud/mcp
All requests require a Bearer token. Use the API token from Step 1.
Claude.ai
Connect directly on Claude.ai with OAuth — no API token needed:
- Go to Claude.ai Settings → Integrations → Add More
- Enter the server URL:
https://suno.mcp.acedata.cloud/mcp - Complete the OAuth login flow
- Start using the tools in your conversation
Claude Desktop
Add to your config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": {
"suno": {
"type": "streamable-http",
"url": "https://suno.mcp.acedata.cloud/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
Cursor / Windsurf
Add to your MCP config (.cursor/mcp.json or .windsurf/mcp.json):
{
"mcpServers": {
"suno": {
"type": "streamable-http",
"url": "https://suno.mcp.acedata.cloud/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
VS Code (Copilot)
Add to your VS Code MCP config (.vscode/mcp.json):
{
"servers": {
"suno": {
"type": "streamable-http",
"url": "https://suno.mcp.acedata.cloud/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
Or install the Ace Data Cloud MCP extension for VS Code, which registers the hosted MCP servers with one-click setup.
JetBrains IDEs
- Go to Settings → Tools → AI Assistant → Model Context Protocol (MCP)
- Click Add → HTTP
- Paste:
{
"mcpServers": {
"suno": {
"url": "https://suno.mcp.acedata.cloud/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
Claude Code
Claude Code supports MCP servers natively:
claude mcp add suno --transport http https://suno.mcp.acedata.cloud/mcp \
-h "Authorization: Bearer YOUR_API_TOKEN"
Or add to your project's .mcp.json:
{
"mcpServers": {
"suno": {
"type": "streamable-http",
"url": "https://suno.mcp.acedata.cloud/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
Cline
Add to Cline's MCP settings (.cline/mcp_settings.json):
{
"mcpServers": {
"suno": {
"type": "streamable-http",
"url": "https://suno.mcp.acedata.cloud/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
Amazon Q Developer
Add to your MCP configuration:
{
"mcpServers": {
"suno": {
"type": "streamable-http",
"url": "https://suno.mcp.acedata.cloud/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
Roo Code
Add to Roo Code MCP settings:
{
"mcpServers": {
"suno": {
"type": "streamable-http",
"url": "https://suno.mcp.acedata.cloud/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
Continue.dev
Add to .continue/config.yaml:
mcpServers:
- name: suno
type: streamable-http
url: https://suno.mcp.acedata.cloud/mcp
headers:
Authorization: "Bearer YOUR_API_TOKEN"
Zed
Add to Zed's settings (~/.config/zed/settings.json):
{
"language_models": {
"mcp_servers": {
"suno": {
"url": "https://suno.mcp.acedata.cloud/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
}
cURL Test
# Health check (no auth required)
curl https://suno.mcp.acedata.cloud/health
# MCP initialize
curl -X POST https://suno.mcp.acedata.cloud/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'
3. Or Run Locally (Alternative)
If you prefer to run the server on your own machine:
# Install from PyPI
pip install mcp-suno
# or
uvx mcp-suno
# Set your API token
export ACEDATACLOUD_API_TOKEN="your_token_here"
# Run (stdio mode for Claude Desktop / local clients)
mcp-suno
# Run (HTTP mode for remote access)
mcp-suno --transport http --port 8000
Claude Desktop (Local)
{
"mcpServers": {
"suno": {
"command": "uvx",
"args": ["mcp-suno"],
"env": {
"ACEDATACLOUD_API_TOKEN": "your_token_here"
}
}
}
}
Docker (Self-Hosting)
docker pull ghcr.io/acedatacloud/mcp-suno:latest
docker run -p 8000:8000 ghcr.io/acedatacloud/mcp-suno:latest
Clients connect with their own Bearer token — the server extracts the token from each request's Authorization header.
Available Tools
Music Generation
| Tool | Description |
|---|---|
generate_music | Generate music from a text prompt (Inspiration Mode) |
generate_custom_music | Generate with custom lyrics, title, and style |
extend_music | Extend an existing song from a timestamp |
cover_music | Create a cover/remix version |
concat_music | Merge extended segments into complete audio |
generate_with_persona | Generate using a saved voice style |
remaster_music | Remaster an existing song to improve audio quality |
stems_music | Separate a song into individual stems (vocals/instruments) |
replace_section | Replace a specific time range with new generated content |
upload_extend | Extend uploaded audio with new AI-generated content |
upload_cover | Create an AI cover of uploaded audio |
mashup_music | Create a mashup by blending multiple songs together |
Lyrics
| Tool | Description |
|---|---|
generate_lyrics | Generate song lyrics from a prompt |
mashup_lyrics | Generate mashup lyrics by combining two sets of lyrics |
optimize_style | Optimize a style description for better generation results |
Media Conversion
| Tool | Description |
|---|---|
get_mp4 | Get an MP4 video version of a generated song |
get_wav | Get lossless WAV format of a generated song |
get_midi | Get MIDI data extracted from a generated song |
get_timing | Get timing and subtitle data for a generated song |
extract_vocals | Extract the vocal track from a generated song |
Persona
| Tool | Description |
|---|---|
create_persona | Save a voice style for reuse |
Upload
| Tool | Description |
|---|---|
upload_audio | Upload an external audio file for use in subsequent operations |
Tasks
| Tool | Description |
|---|---|
get_task | Query a single task status |
get_tasks_batch | Query multiple tasks at once |
Information
| Tool | Description |
|---|---|
list_models | List available Suno models |
list_actions | List available API actions |
get_lyric_format_guide | Get lyrics formatting guide |
Usage Examples
Generate Music from Prompt
User: Create a happy birthday song
Claude: I'll generate a birthday song for you.
[Calls generate_music with prompt="A happy birthday celebration song"]
Generate with Custom Lyrics
User: Create a rock song with these lyrics:
[Verse]
Thunder in the night
Electric soul ignite
[Chorus]
We are the storm
Claude: I'll create a rock song with your lyrics.
[Calls generate_custom_music with lyrics, title="Storm", style="rock, powerful"]
Extend a Song
User: Continue this song from the 2-minute mark with a bridge section
Claude: I'll extend the song with a bridge.
[Calls extend_music with audio_id, continue_at=120, lyric="[Bridge]..."]
Available Models
| Model | Version | Max Duration | Features |
|---|---|---|---|
chirp-v5-5 | V5.5 | 8 minutes | Latest, best quality |
chirp-v5 | V5 | 8 minutes | High quality |
chirp-v4-5-plus | V4.5+ | 8 minutes | Enhanced quality |
chirp-v4-5 | V4.5 | 4 minutes | Vocal gender control |
chirp-v4 | V4 | 150 seconds | Stable |
chirp-v3-5 | V3.5 | 120 seconds | Fast |
chirp-v3-0 | V3 | 120 seconds | Legacy |
Vocal Gender Control (v4.5+ only):
f- Female vocalsm- Male vocals
Configuration
Environment Variables
| Variable | Description | Default |
|---|---|---|
ACEDATACLOUD_API_TOKEN | API token from AceDataCloud | Required |
ACEDATACLOUD_API_BASE_URL | API base URL | https://api.acedata.cloud |
ACEDATACLOUD_OAUTH_CLIENT_ID | OAuth client ID (hosted mode) | — |
ACEDATACLOUD_PLATFORM_BASE_URL | Platform base URL | https://platform.acedata.cloud |
SUNO_DEFAULT_MODEL | Default model for generation | chirp-v5-5 |
SUNO_REQUEST_TIMEOUT | Request timeout in seconds | 1800 |
LOG_LEVEL | Logging level | INFO |
Command Line Options
mcp-suno --help
Options:
--version Show version
--transport Transport mode: stdio (default) or http
--port Port for HTTP transport (default: 8000)
Development
Setup Development Environment
# Clone repository
git clone https://github.com/AceDataCloud/SunoMCP.git
cd SunoMCP
# Create virtual environment
python -m venv .venv
source .venv/bin/activate # or `.venv\Scripts\activate` on Windows
# Install with dev dependencies
pip install -e ".[dev,test]"
Run Tests
# Run unit tests
pytest
# Run with coverage
pytest --cov=core --cov=tools
# Run integration tests (requires API token)
pytest tests/test_integration.py -m integration
Code Quality
# Format code
ruff format .
# Lint code
ruff check .
# Type check
mypy core tools
Build & Publish
# Install build dependencies
pip install -e ".[release]"
# Build package
python -m build
# Upload to PyPI
twine upload dist/*
Project Structure
SunoMCP/
├── core/ # Core modules
│ ├── __init__.py
│ ├── client.py # HTTP client for Suno API
│ ├── config.py # Configuration management
│ ├── exceptions.py # Custom exceptions
│ ├── server.py # MCP server initialization
│ └── utils.py # Utility functions
├── tools/ # MCP tool definitions
│ ├── __init__.py
│ ├── audio_tools.py # Audio generation tools
│ ├── info_tools.py # Information tools
│ ├── lyrics_tools.py # Lyrics generation tools
│ ├── media_tools.py # Media conversion tools
│ ├── persona_tools.py # Persona management tools
│ └── task_tools.py # Task query tools
├── tests/ # Test suite
│ ├── conftest.py
│ ├── test_client.py
│ ├── test_config.py
│ ├── test_integration.py
│ └── test_utils.py
├── deploy/ # Deployment configs
│ └── production/
│ ├── deployment.yaml
│ ├── ingress.yaml
│ └── service.yaml
├── .env.example # Environment template
├── .gitignore
├── CHANGELOG.md
├── Dockerfile # Docker image for HTTP mode
├── docker-compose.yaml # Docker Compose config
├── LICENSE
├── main.py # Entry point
├── pyproject.toml # Project configuration
└── README.md
API Reference
This server wraps the AceDataCloud Suno API:
- Suno Audios API - Music generation
- Suno Lyrics API - Lyrics generation
- Suno Tasks API - Task queries
- Suno Persona API - Persona management
Contributing
Contributions are welcome! Please:
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing) - Open a Pull Request
License
MIT License - see LICENSE for details.
Links
Made with love by AceDataCloud
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →Configuration
ACEDATACLOUD_API_TOKEN*secretAPI token from Ace Data Cloud (https://platform.acedata.cloud)
Categories
Registryactive
Packagemcp-suno
TransportSTDIO, HTTP
AuthRequired
UpdatedJun 9, 2026
