mcp-suno

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.

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.

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.

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.

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.

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)

For quick generation without writing lyrics, use suno_generate_music instead.

Returns:
    Task ID and generated audio information including URLs, title, lyrics, and duration.

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.

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.

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.

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.

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.

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.

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
- 'complete': Generation finished successfully
- 'failed': Generation failed (check error message)

Returns:
    Task status and generated audio information including URLs, title, lyrics, and duration.

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

Returns:
    Status and audio information for all queried tasks.

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.

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.

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.

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-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.

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.

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.

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.

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.

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 and the updated audio information.

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.

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 to extend/cover with Suno
- You want to use an external audio as a base for Suno operations
- You need to import audio into Suno's system

After uploading, use the returned audio_id with suno_upload_extend or
suno_upload_cover actions.

Returns:
    Upload result with audio ID for use in subsequent operations.

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.

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.