MCP-Suno
Generate lyrics and music using Suno's AI music generation API, with support for custom styles and model selection.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP-Suno generate an upbeat pop song about dancing in the rain"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP-Suno
MCP (Model Context Protocol) server for Suno music generation API.
Features
Generate Lyrics: Create lyrics based on a description or theme
Generate Music: Create custom songs with lyrics, style tags, and model selection
Automatic Polling: Built-in polling mechanism for async task completion
Related MCP server: Suno MCP
Installation
Clone or download this repository
Install dependencies:
npm installSet up your API key by creating a
.envfile:
cp .env.example .envEdit .env and add your Suno API key:
SUNO_API_KEY=your_actual_api_key_hereBuilding
npm run buildRunning
npm startOr for development:
npm run devMCP Configuration
Add this server to your MCP client configuration:
{
"mcpServers": {
"suno": {
"type": "stdio",
"command": "node",
"args": ["E:\\xxx\\xxx\\xxx\\suno-mcp-1313api\\dist\\index.js"],
"env": {
"SUNO_API_KEY": "your_api_key_here"
}
"timeout": 600,
}
}
}Available Tools
generate_lyrics
Generate lyrics based on a description or theme.
Parameters:
prompt(required): Description or theme for lyrics (e.g., "dance", "love song", "epic battle")
Returns:
task_id: The task ID for trackingtitle: Generated song titlelyrics: Full lyrics textstatus: Task completion status
Example:
{
"prompt": "a romantic sunset song about two lovers meeting"
}generate_music
Generate music with custom lyrics.
Parameters:
prompt(required): The lyrics for the song in Suno format (with [Verse], [Chorus], [Bridge] tags)title(required): Title of the songtags(optional): Music style tags (e.g., "pop, upbeat, female vocals", "rock, energetic")mv(optional): Model version (default: "chirp-v4")
Returns:
task_id: The task ID for trackingsongs: Array of generated songs with:id: Song IDtitle: Song titletags: Style tagsaudio_url: MP3 audio file URLvideo_url: MP4 video file URLimage_url: Cover image URLimage_large_url: Large cover image URLduration: Song duration in secondsmodel_name: Model usedstatus: Generation statuslyrics: Full lyrics text
Example:
{
"prompt": "[Verse]\nWalking down the street\nFeeling the beat\nMusic in my soul\nTaking control\n\n[Chorus]\nThis is my song\nSinging all night long\nFeel the rhythm\nMoving along",
"title": "My Song",
"tags": "pop, upbeat, electronic",
"mv": "chirp-v4"
}API Endpoints
This MCP server uses the following API endpoints:
Submit Lyrics:
POST https://1313api.top/suno/submit/lyricsSubmit Music:
POST https://1313api.top/suno/submit/musicFetch Task:
GET https://1313api.top/suno/fetch/{task_id}
Polling Behavior
The server automatically polls for task completion with the following settings:
Max Attempts: 60
Polling Interval: 3 seconds
Total Timeout: ~3 minutes
Tasks are polled until they reach SUCCESS or FAILED status, or timeout is reached.
Error Handling
The server returns error messages in the following format:
{
"error": "Error message description"
}Common errors:
SUNO_API_KEY environment variable is not set: API key not configuredFailed to submit lyrics generation: API request failedTask failed: Generation failed on the serverTask timeout: Generation took too long
License
MIT
Available Tools
2 toolsgenerate_lyricsA
Generate lyrics based on a description or theme. Returns the generated lyrics with title.
Inputs: prompt (required).
generate_musicA
生成自定义音乐。返回生成的歌曲,包含音频URL、视频URL和封面图片。纯音乐模式下prompt留空,make_instrumental为true
Inputs: tags (required), title (required), mv, prompt, +2 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
generate_lyrics and generate_music have clearly distinct outputs: one returns text (lyrics), the other returns audio/video (music). Their names and descriptions make the separation unambiguous.
Both tools follow the exact same 'generate_<noun>' pattern, using snake_case consistently. This creates a predictable and coherent naming convention.
With only 2 tools, the server feels thin for a music generation service. While the tools cover core generation, the count is borderline and would benefit from additional management or status tools.
The server only offers generation, lacking any way to list, retrieve, or manage past generations. For a realistic workflow, agents need status checks or history access, making the surface significantly incomplete.
Maintenance
Related MCP Connectors
Generate Suno AI music (v5.5) from any MCP client. Async; billed only on success.
MCP server for Producer/Riffusion AI music generation
MCP server for OpenAI API (chat completions, image generation, embeddings) via AceDataCloud
MCP server for Google Veo AI video generation
Related MCP Servers
- AlicenseNot gradedqualityAmaintenanceAn MCP server that enables local AI models to automatically generate lyrics and style prompts, then submit songs to Suno via browser automation.MIT
- AlicenseAqualityBmaintenanceAn MCP server that generates music using your Suno account, enabling credit checking, song generation, and MP3 downloads without third-party APIs.2737 PyPIMIT
- AlicenseBqualityBmaintenanceA RunAPI MCP server for the Suno music generation models, enabling task creation (text-to-music, covers, mashups, etc.), polling, and pricing lookup through a single API key.2196 npm2Apache 2.0
- AlicenseAqualityDmaintenanceGenerate music with Suno (v5.5) from any MCP client — async, and billed only on successful renders (a failed render auto-refunds). Hosted Streamable-HTTP server; tools generate_song / wait_for_song / check_song.32 npmMIT