io.github.AceDataCloud/mcp-suno

Archive a custom music model so it can no longer be used. Archiving does not guarantee that model capacity is released.

Create a reusable custom music model from authorized audio examples. This is a paid, long-running operation. Call it only after the user confirms the source files and the 5.6-Credit list price.

Retrieve a single custom music model by ID.

List custom music models for the current Suno application.

Generate a song using a ready custom music model. The initial response only accepts the async task. Poll it until success or failure; this operation never falls back to another model.

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-v6: Current v6 model - chirp-v6-wild: v6 Wild model - chirp-v6-mini: v6 Mini model - chirp-v5-5: Previous model name, retained for compatibility - chirp-v5: High quality, 8-minute max duration - chirp-v4-5-plus: High quality with 8-minute duration - chirp-v4-5: Recommended balance of quality and speed, 4-minute duration - chirp-v4: Good quality, 150 seconds max - chirp-v3-5/v3: Legacy models, 120 seconds max Returns: Table of all models with their version, limits, and features.

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.

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 section markers, examples, and tips.

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 platforms - You want a visual representation of the audio Returns: Task ID and MP4 video information.

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 need word-level timing for video editing Returns: Timing data with word-level timestamps.

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 remix or mashup - You want to create a persona from specific vocal segments Returns: Task ID and extracted vocal audio information.

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 output - You need uncompressed audio for further processing Returns: Task ID and WAV audio information.

Get the MP3 format of a generated song. Converts the song to MP3 format, which is compact and widely supported across playback devices and platforms. Use this when: - You need a compressed and portable audio format - You want to share songs easily across platforms - You prefer smaller file sizes than WAV Returns: Task ID and MP3 audio information.

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 from the song - You want to recreate the song with different instruments Returns: Task ID and MIDI data information.

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 song and love the voice - You want to create multiple songs with the same vocalist - You're building an album with consistent vocal style - You want to save a unique voice for future use After creating a persona, use suno_generate_with_persona with the returned persona_id to generate new songs with that voice. Returns: Persona ID that can be used with suno_generate_with_persona tool.

List all saved artist personas for a user. Returns all personas previously created with suno_create_persona or suno_create_voice for the given user. Use this when: - You want to see all available voice personas - You need to find a persona ID to use in music generation - You want to manage your saved vocal styles Returns: List of personas with their IDs, names, and descriptions.

Delete a saved artist persona. Permanently removes a previously created persona. This action cannot be undone. Use this when: - You want to remove an unused voice persona - You need to clean up old personas - You want to delete a persona you no longer need Returns: Confirmation of the deletion.

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 from a previous generation - You want to get the full details of a generated song Task states: - 'pending': Generation is still in progress — KEEP POLLING - 'processing': Generation is being processed — KEEP POLLING - 'complete': Generation finished successfully - 'failed': Generation failed (check error message) The API may omit its top-level state. The MCP normalizes response.success=true to complete and response.success=false to failed; responses without a success field remain pending. Returns: Task status and generated audio information including URLs, title, lyrics, and task timing metadata.

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 songs at once - You're tracking a batch of generations The MCP treats response.success=true as complete and response.success=false as failed when the API omits its top-level state. Returns: Status and audio information for all queried tasks.

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 want to write them yourself - You want AI-generated lyrics for a specific theme or mood - You need properly structured lyrics with section markers The output includes section markers like [Verse], [Chorus], [Bridge] that Suno's music generation understands. Returns: Generated lyrics with title, status, and formatted text with section markers.

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 with minimal input - You don't have specific lyrics in mind - You want Suno to be creative with the arrangement For full control over lyrics and style, use suno_generate_custom_music instead. Returns: Task ID and generated audio information including URLs, title, lyrics, and duration.

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 want to use - You want precise control over the music style - You need a specific song title - You want to specify vocal gender (v4.5+ models) - You want the API to auto-generate lyrics from a prompt (use lyric_prompt) - You need a specific track length (use duration) For quick generation without writing lyrics, use suno_generate_music instead. Returns: Task ID and generated audio information including URLs, title, lyrics, and duration.

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 add a bridge or outro to an existing song - You're building a longer song piece by piece After extending multiple times, use suno_concat_music to merge all segments. Returns: Task ID and the extended audio information.

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 acoustic/unplugged version of an electronic song - You want to remix a song with a different vibe Returns: Task ID and the cover audio information.

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 single audio file instead of multiple segments - You're ready to finalize a long-form composition Returns: Task ID and the concatenated audio information with the full song.

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 an album or series with consistent vocals - You found a voice you like and want to reuse it First create a persona with suno_create_persona, then use its ID here. Returns: Task ID and generated audio information with the persona's voice applied.

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 with an older model to sound better - You need a polished, production-ready version Returns: Task ID and the remastered audio information.

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 stem tracks for mixing - You want to create a karaoke version Returns: Task ID and stem separation results with individual track URLs.

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 improvement - You want to change lyrics in the middle of a song - You want to replace a verse or chorus with something different Returns: Task ID plus two complete songs by default, or two unmerged clips in candidates mode.

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 - You want to add AI-generated sections to your existing recordings Returns: Task ID and the extended audio information.

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 want to hear your song re-interpreted by AI Returns: Task ID and the cover audio information.

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 musically - You're creating a DJ-style mashup - You want to combine melodies from different songs Returns: Task ID and the mashup audio information.

Separate a song into all individual stems (vocals, bass, drums, other instruments). Splits the audio into multiple separate tracks for all components, providing more granular stem separation than suno_stems_music. The service may return two same-named sets of 12 stems without metadata that distinguishes the sets; both sets are preserved so no audio is silently discarded. Use this when: - You need full multi-track stem separation - You want individual instrument tracks for remixing - You need bass, drums, and other instrument tracks separately Returns: Task ID and all stem separation results with individual track URLs.

Generate music using a saved artist persona with VOX-specific consistency. Similar to suno_generate_with_persona but uses the artist_consistency_vox action, which is optimized for vocal consistency with a persona. Use this when: - You want multiple songs with the same vocal style using VOX mode - You need stricter vocal consistency than suno_generate_with_persona provides - You're creating content with a specific voice persona First create a persona with suno_create_persona or suno_create_voice, then use its ID here. Returns: Task ID and generated audio information with the persona's voice applied.

Add AI-generated accompaniment/instrumental background to uploaded audio. Takes your uploaded vocal track and adds an AI-generated instrumental accompaniment beneath it (underpainting = adding music under vocals). Use this when: - You have a vocal recording and want to add music behind it - You want to give an acapella track a full musical arrangement - You need to add instrumental backing to existing vocals Returns: Task ID and the audio with accompaniment added.

Add AI-generated vocals to uploaded instrumental audio. Takes your uploaded instrumental track and adds AI-generated vocals on top of it (overpainting = painting vocals over the music). Use this when: - You have an instrumental track and want to add vocals - You want to give background music a singing voice - You need to add vocal melody to existing music Returns: Task ID and the audio with vocals added.

Add AI-generated samples to uploaded audio. Takes your uploaded audio and adds AI-generated musical samples within the specified time range. Use this when: - You want to add sample loops or motifs to existing music - You need to enhance a track with additional musical elements - You want to add AI-generated samples to a specific section Returns: Task ID and the audio with samples added.

Generate brand-new music inspired by 1 to 4 reference audios (Suno Inspo / 灵感创作). Unlike a cover, inspo does not reproduce the source tracks - it draws stylistic inspiration from them and composes a fresh song guided by your prompt and style tags. Use this when: - You have reference tracks whose vibe you want to riff on - You want a new song "in the style of" some audio you provide Returns: Task ID and generated audio information including URLs, title, lyrics, and duration.

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 it - You want better style prompts for suno_generate_custom_music - You need suggestions for style terms Returns: Optimized style description ready for use in music generation.

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 mashup or medley - You want creative lyrical combinations from two sources Returns: Combined mashup lyrics ready for use in music generation.

Upload external audio for use in subsequent operations. Use standard mode for normal uploads. Use enhanced mode only when standard upload cannot process authorized audio; it returns a task_id for suno_get_task. Enhanced audio IDs support Cover, Samples, and Mashup.

Create a custom voice persona from an external audio URL. Creates a voice persona directly from a publicly accessible audio URL (MP3 or WAV format). The audio must contain clear vocals from a single speaker and be at least 10 seconds long. This is different from suno_create_persona which creates a persona from a previously generated Suno audio. Use this to create a persona from your own voice recordings or external audio files. Use this when: - You have an external audio file with clear vocals - You want to create a voice persona from your own recordings - You want to use a specific real-world voice as a persona Returns: Persona ID that can be used with suno_generate_with_persona tool.