Suno MCP Server

A Model Context Protocol (MCP) server for AI music generation using Suno through the AceDataCloud API. Its 28 documented tools cover suno, music, generate, extend.

People connecting media tools to Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-08-23 · ★ 44 · #12 OF 155 MAINTAINED MEDIA · VERIFIED 2026-08-25

MIT · Python servers · how we verify → /methodology

01 · Install Suno

before you install - you'll need

Set ACEDATACLOUD_API_TOKEN before connecting.

Claude Code

claude mcp add acedatacloud-sunomcp --transport http https://suno.mcp.acedata.cloud/mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "acedatacloud-sunomcp": {
      "url": "https://suno.mcp.acedata.cloud/mcp"
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

https://suno.mcp.acedata.cloud/mcp

transport: streamable-http

endpoint alive - authentication required · probed 2026-08-25

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions · remote - your agent's requests go to suno.mcp.acedata.cloud

endpoint auth requires authentication - rejected our unauthenticated MCP initialize

license MIT - declared in the repository

pypi package mcp-suno - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.AceDataCloud is GitHub-verified and matches the repo owner

03 · What Suno can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can create a cover or remix version of an existing song in a different style, generate music using a saved artist persona for consistent vocal style, replace a specific time range in a song with new generated content, and create an AI cover of an uploaded audio (your own music).

The 28 tools it gives your agent

Extracted from the project's README - what mcp-suno lets an agent do.

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; v5/v5.5 require a variation category.
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
- Blend exactly two songs using a required creative-direction prompt.
show all 28 tools
suno_all_stems_music
- Return two distinct 12-stem candidate sets, labeled stem_set 1 and 2 in task results.
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 a required vocal interval shorter than 30 seconds.
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.

Latest releases

v2026.8.24.0 · 2026-08-24

v2026.8.23.0 · 2026-08-23

v2026.8.18.0 · 2026-08-18

04 · Who maintains Suno

mcp-suno is maintained by acedatacloud. We track 25 MCP servers from acedatacloud - 24 actively maintained, 94 combined GitHub stars, oldest repo from Jan 2026. Full record: all servers from acedatacloud.

  1. mcp-seedance MCP server for ByteDance Seedance AI video generation ★ 17
  2. Midjourney MCP server for Midjourney AI image generation and editing ★ 8
  3. mcp-nanobanana-pro MCP server for NanoBanana AI image generation and editing ★ 7
  4. mcp-seedream-pro MCP server for ByteDance Seedream AI image generation ★ 3
  5. mcp-flux-pro MCP server for Flux AI image generation ★ 3
  6. mcp-veo MCP server for Google Veo AI video generation ★ 3

05 · Facts

category
media - ranked #12 of 155 actively-maintained media servers as of 2026-08-25.
release cadence
10+ releases in the last 90 days (latest 2026-08-24)
registry
io.github.AceDataCloud/mcp-suno (active, first published 2026-03-19 · 57 versions)
packages
pypi:mcp-suno

06 · Suno FAQ

Is Suno still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-23 and it shipped 10+ releases in the last 90 days. We re-verify nightly.

What can Suno do?

With this server connected, an agent can create a cover or remix version of an existing song in a different style, generate music using a saved artist persona for consistent vocal style, replace a specific time range in a song with new generated content, and create an AI cover of an uploaded audio (your own music).

How do I install Suno?

Run `uvx mcp-suno`. The README documents one environment variable (ACEDATACLOUD_API_TOKEN) to set first. Set ACEDATACLOUD_API_TOKEN before connecting. You can also paste the ready-made client config above.

Does Suno require authentication?

Yes - when we probed the endpoint on 2026-08-25, it rejected an unauthenticated MCP initialize; you'll need credentials to connect.

07 · Alternatives to Suno