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.
- mcp-seedance MCP server for ByteDance Seedance AI video generation ★ 17
- Midjourney MCP server for Midjourney AI image generation and editing ★ 8
- mcp-nanobanana-pro MCP server for NanoBanana AI image generation and editing ★ 7
- mcp-seedream-pro MCP server for ByteDance Seedream AI image generation ★ 3
- mcp-flux-pro MCP server for Flux AI image generation ★ 3
- mcp-veo MCP server for Google Veo AI video generation ★ 3
05 · Facts
- repository
- github.com/acedatacloud/sunomcp
- website
- https://suno.mcp.acedata.cloud/
- 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
Alternatives to Suno
Maintained media servers if Suno isn't the fit.
- Openshorts Turn long videos into viral vertical shorts and publish them to TikTok, Instagram and YouTube. ★ 3,410 · 2026-08-25
- Claude Real Video Let any LLM watch a video locally - and search everything it has ever watched. ★ 2,061 · 2026-08-22
- Voicemode Natural voice conversations for AI assistants - STT/TTS via MCP ★ 1,337 · 2026-08-09
- Nova3 D Structured, part-aware 3D generation for AI agents. Named-part GLB, preview URL, Blender script. ★ 682 · 2026-08-12
- Comfyui MCP MCP server + Claude Code plugin for ComfyUI: run workflows, generate images, manage models & VRAM. ★ 671 · 2026-08-25
- Yutu The AI-powered toolkit that grows your YouTube channel on autopilot ★ 620 · 2026-08-23
More media MCP servers · Veo · Aetherwave MCP · AIOProductOS Studio · Server Alice · Storyflo
More Python MCP servers · Actenon Kernel · Adamamer20 Paper Search MCP OpenAI · Gigamail · FastMCP server for Apollo · see all