acedatacloud avatar

Suno by Ace Data Cloud

acedatacloud/sunomcp

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.

GitHub stars
73
tools
27
auth
Secret needed
transport
STDIO, HTTP
env var
1
last updated
Nov 12, 2026

Tools

27 tools

Public tool metadata for what this MCP can expose to an agent.

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
callback_urlvalue
Webhook callback URL for asynchronous notifications. When provided, the API will call this URL when the audio is generated.
instrumentalboolean
If true, generate instrumental music without vocals. Default is false (with vocals).default: false
modelstring
Suno 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-5
promptstring
Description 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 c...
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
callback_urlvalue
Webhook callback URL for asynchronous notifications. When provided, the API will call this URL when the audio is generated.
instrumentalboolean
If true, generate instrumental version (lyrics will be ignored). Default is false.default: false
lyricstring
Song 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...
modelstring
Suno 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-5
stylestring
Music style description. Be specific about genre, mood, tempo, and instruments. Examples: 'upbeat pop rock, energetic drums, electric guitar', 'acoustic folk, gentle, fingerpicking', 'dark electron...default:
style_negativestring
Styles to explicitly exclude from the generation. Examples: 'heavy metal, screaming', 'autotune, electronic'default:
titlestring
Title of the song. Keep it concise and memorable.
vocal_genderstring
Preferred vocal gender. 'f' for female, 'm' for male, empty string for AI to decide. Only works with v4.5+ models.one of · f · mdefault:
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
audio_idstring
ID of the audio to extend. This is the 'id' field from a previous generation result.
callback_urlvalue
Webhook callback URL for asynchronous notifications. When provided, the API will call this URL when the extension is complete.
continue_atnumber
Timestamp in seconds where to start the extension. For example, 120.5 means continue from 2 minutes and 0.5 seconds into the song.
lyricstring
Lyrics for the extended section. Use section markers like [Verse], [Chorus], [Bridge], [Outro]. The extension will continue from where the original song left off.
modelstring
Model 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-5
stylestring
Music style for the extension. Leave empty to maintain the original style, or specify to change the style mid-song.default:
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
audio_idstring
ID of the audio to create a cover of. This is the 'id' field from a previous generation.
callback_urlvalue
Webhook callback URL for asynchronous notifications. When provided, the API will call this URL when the cover is complete.
modelstring
Model 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-5
promptstring
Description of how you want the cover to sound. Examples: 'acoustic unplugged version', 'jazz lounge style', '80s synthwave remix'default:
stylestring
Target music style for the cover. Examples: 'jazz, smooth, saxophone', 'acoustic folk, gentle guitar', 'electronic dance, high energy'default:
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_idstring
ID of the LAST segment of an extended song chain. Suno will automatically find and merge all connected segments.
callback_urlvalue
Webhook 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
audio_idstring
ID of a reference audio to base the generation on.
callback_urlvalue
Webhook callback URL for asynchronous notifications. When provided, the API will call this URL when the audio is generated.
modelstring
Model version to use.one of chirp-v3-0 · chirp-v3-5 · chirp-v4 · chirp-v4-5 · chirp-v4-5-plus · chirp-v5default: chirp-v4-5
persona_idstring
ID of the persona to use. Get this from suno_create_persona tool. The persona defines the vocal style and characteristics.
promptstring
Description of the music to generate. The persona's voice will be applied to this new song.
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
audio_idstring
ID of the audio to remaster. This is the 'id' field from a previous generation.
callback_urlvalue
Webhook callback URL for asynchronous notifications.
modelstring
Model 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-5
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_idstring
ID of the audio to separate into stems.
callback_urlvalue
Webhook 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
audio_idstring
ID of the audio to replace a section in.
callback_urlvalue
Webhook callback URL for asynchronous notifications.
lyricvalue
New lyrics for the replaced section. Use section markers like [Verse], [Chorus].
modelstring
Model version to use.one of chirp-v3-0 · chirp-v3-5 · chirp-v4 · chirp-v4-5 · chirp-v4-5-plus · chirp-v5default: chirp-v4-5
replace_section_endnumber
End time in seconds of the section to replace.
replace_section_startnumber
Start time in seconds of the section to replace.
stylestring
Music style for the replaced section.default:
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
audio_idstring
ID of the uploaded audio to extend. Must be an audio uploaded via suno_upload_audio.
callback_urlvalue
Webhook callback URL for asynchronous notifications.
continue_atnumber
Timestamp in seconds where to start the extension.
lyricstring
Lyrics for the extension section.
modelstring
Model version to use.one of chirp-v3-0 · chirp-v3-5 · chirp-v4 · chirp-v4-5 · chirp-v4-5-plus · chirp-v5default: chirp-v4-5
stylestring
Music style for the extension.default:
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
audio_idstring
ID of the uploaded audio to create a cover of. Must be an audio uploaded via suno_upload_audio.
callback_urlvalue
Webhook callback URL for asynchronous notifications.
modelstring
Model version to use.one of chirp-v3-0 · chirp-v3-5 · chirp-v4 · chirp-v4-5 · chirp-v4-5-plus · chirp-v5default: chirp-v4-5
stylestring
Target music style for the cover.default:
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
callback_urlvalue
Webhook callback URL for asynchronous notifications.
mashup_audio_idsarray
List of audio IDs to mashup together. Provide 2 or more song IDs.
modelstring
Model version to use.one of chirp-v3-0 · chirp-v3-5 · chirp-v4 · chirp-v4-5 · chirp-v4-5-plus · chirp-v5default: chirp-v4-5
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
modelstring
Model version for lyrics generation. 'default' works well for most lyrics. 'remi-v1' offers an alternative style.one of default · remi-v1default: default
promptstring
Description 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'...
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_idstring
The 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_idstring
The 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_idstring
The song ID to extract vocals from.
callback_urlvalue
Webhook callback URL for asynchronous notifications.
vocal_endvalue
End time in seconds for the vocal extraction range.
vocal_startvalue
Start time in seconds for the vocal extraction range.
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_idstring
The song ID to get the WAV format for.
callback_urlvalue
Webhook 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_idstring
The song ID to get MIDI data for.
callback_urlvalue
Webhook 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
audio_idstring
ID 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.
descriptionvalue
Description of the singer's style. Examples: 'Warm and breathy female voice with jazz influences', 'Powerful male rock vocalist with raspy tone'
namestring
Name 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'
vocal_endvalue
End time in seconds of the vocal segment to use from the audio.
vocal_startvalue
Start time in seconds of the vocal segment to use from the audio. Useful for isolating a specific vocal section.
vox_audio_idvalue
Optional 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
promptstring
Style 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_astring
The first set of lyrics to combine. Can be full song lyrics with section markers.
lyrics_bstring
The 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_urlstring
Public 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_idstring
The 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_idsarray
List of task IDs to query. Maximum recommended batch size is 50 tasks.

Sponsors

Configuration

ACEDATACLOUD_API_TOKEN*secret

API token from Ace Data Cloud (https://platform.acedata.cloud)

Readme

Suno by Ace Data Cloud

简体中文安装与首用指南

PyPI version PyPI downloads Python 3.10+ License: MIT MCP

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.

Use Suno in Glama


View the full README on GitHub

Details

Repository
github.com/acedatacloud/sunomcp
Website
platform.acedata.cloud/documents/suno-mcp?utm_source=mcp_registry&utm_medium=referral&utm_campaign=evergreen&utm_content=suno_mcp_listing_guide
Categories
Data & Analytics, Media & Entertainment, Productivity & Office
Package
mcp-suno
Transport
STDIO, HTTP
Auth
Required
Registry
MCP registry, active

More from acedatacloud

Related Data & Analytics MCP servers

View all
1fliptheweb avatarYazio Mcpfliptheweb/yazio-mcpMCP server for accessing Yazio user & nutrition data (unofficial)72stars
2briangaoo avatarWhoop Mcpbriangaoo/whoop-mcpFull read + write access to your Whoop fitness data via the private iOS API. 48 tools.67stars
3ondata avatarCkan Mcp Serverondata/ckan-mcp-serverMCP server for interacting with CKAN open data portals61stars
4dweekly avatarQuicken Mac Mcpdweekly/quicken-mac-mcpRead-only access to Quicken For Mac financial data: transactions, spending, and portfolios.55stars
5affitor avatarOpenaffiliate Mcpaffitor/open-affiliateSearch and discover affiliate programs with agent-ready data and commission details.55stars
6isdaniel avatarWeather MCP Serverisdaniel/mcp_weather_serverproviding weather information, air quality data, and timezone utilities using the Open-Meteo API.50stars