Suno MCP Server
A Model Context Protocol (MCP) server for AI music generation using Suno through the AceDataCloud API. Its 34 documented tools cover suno, music, custom, model.
People who work with suno, music and custom and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in Python.
VERIFIED ACTIVE
LAST COMMIT 2026-09-09 · ★ 54 · #13 OF 173 MAINTAINED MEDIA · VERIFIED 2026-09-18
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-09-17
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 34 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 34 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_mp3
- - Get the compressed MP3 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_create_custom_model
- - Create a reusable custom music model from 6 to 24 authorized audio URLs.
- suno_get_custom_model
- - Retrieve one custom music model by ID.
- suno_list_custom_models
- - List custom music models for the current Suno application.
- suno_generate_with_custom_model
- - Generate a song using a ready custom music model.
- suno_delete_custom_model
- - Archive a custom music model so it can no longer be used.
- 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 external audio in standard or enhanced mode for 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.9.9.0 · 2026-09-09
v2026.9.6.1 · 2026-09-06
v2026.9.6.0 · 2026-09-06
04 · Who maintains Suno
mcp-suno is maintained by acedatacloud. We track 25 MCP servers from acedatacloud - 24 actively maintained, 108 combined GitHub stars, oldest repo from Jan 2026. Full record: all servers from acedatacloud.
- mcp-seedance MCP server for ByteDance Seedance AI video generation ★ 18
- Midjourney MCP server for Midjourney AI image generation and editing ★ 9
- 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 #13 of 173 actively-maintained media servers as of 2026-09-18.
- release cadence
- 10+ releases in the last 90 days (latest 2026-09-09)
- registry
- io.github.AceDataCloud/mcp-suno (active, first published 2026-03-19 · 69 versions)
- packages
- pypi:mcp-suno
06 · Suno FAQ
Is Suno still maintained?
Yes - as of 2026-09-18, its last commit was 2026-09-09 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-09-17, 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. ★ 5,045 · 2026-09-17
- Claude Real Video Let any LLM watch a video locally - and search everything it has ever watched. ★ 2,158 · 2026-09-11
- Minutes The private, owned conversation-memory layer for AI. Record, transcribe, and search every meeting. ★ 1,485 · 2026-09-18
- Voicemode Natural voice conversations for AI assistants - STT/TTS via MCP ★ 1,368 · 2026-09-15
- Comfyui MCP MCP server + Claude Code plugin for ComfyUI: run workflows, generate images, manage models & VRAM. ★ 755 · 2026-09-14
- Nova3 D Structured, part-aware 3D generation for AI agents. Named-part GLB, preview URL, Blender script. ★ 714 · 2026-08-12
More media MCP servers · Veo · Aetherwave MCP · AIOProductOS Studio · Server Alice · Video Overlay Kit
More Python MCP servers · Actenon Kernel · Adamamer20 Paper Search MCP OpenAI · Gigamail · FastMCP server for Apollo · see all