Config is the same across clients — only the file and path differ.
{
"mcpServers": {
"suno": {
"env": {
"RUNAPI_API_KEY": "${RUNAPI_API_KEY}"
},
"args": [
"-y",
"@runapi.ai/suno-mcp"
],
"command": "npx"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
RunAPI MCP server for the Suno model line. Create tasks, poll their status, and check pricing through a single RunAPI API key.
Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.
npx -y '@runapi.ai/suno-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Five weighted categories — click any category to see the underlying evidence.
No known CVEs.
Checked @runapi.ai/suno-mcp against OSV.dev.
Click any tool to inspect its schema.
Be the first to review
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Others in other
Pi Coding Agent extension (CLI-first) — routes bash/read/grep/find/ls through lean-ctx CLI for strong token savings. Optional MCP bridge can register advanced tools.
Compress tool outputs, logs, files, and RAG chunks before they reach the LLM. 60-95% fewer tokens, same answers. Library, proxy, MCP server.
97% token reduction for AI coding sessions — zero deps, 21 languages, MCP server
Autonomous spec-to-product coding-agent CLI with an MCP server exposing 34 tools over stdio.
MCP Security Weekly
Get CVE alerts and security updates for io.github.runapi-builder/suno-mcp and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
Suno API access for AI agents: create multimodal generation tasks, poll results, and check pricing through one focused MCP server.
Works with Claude Code, Codex, Cursor, Windsurf, VS Code, Roo Code, and any MCP-compatible host.
Install | Tools | Models | Agent Prompts | Configuration | Links
@runapi.ai/suno-mcp is a focused Model Context Protocol server for the Suno model line on RunAPI.
It gives MCP-compatible assistants direct access to 6 endpoints and 6 model variants without loading the full RunAPI catalog.
Use this per-model server when an agent should stay scoped to Suno. Use @runapi.ai/mcp when one assistant should discover every RunAPI model line.
Add it to Claude Code:
claude mcp add suno -s user -- npx -y @runapi.ai/suno-mcp
Use project scope when the server should be shared with a repository:
claude mcp add suno -s project -- npx -y @runapi.ai/suno-mcp
Codex, Cursor, Windsurf, VS Code, Roo Code, and other MCP hosts can use the same stdio command:
{
"mcpServers": {
"suno": {
"command": "npx",
"args": ["-y", "@runapi.ai/suno-mcp"],
"env": { "RUNAPI_API_KEY": "${RUNAPI_API_KEY}" }
}
}
}
Create an API key at runapi.ai and expose it as RUNAPI_API_KEY. check_pricing can run without a key; task creation and status polling require one.
Ready-made examples are in examples/ for Claude, Cursor, Windsurf, VS Code, and Roo Code.
| Tool | Auth | Purpose |
|---|---|---|
cover_audio | Yes | Create a Suno cover audio task and optionally wait for a terminal status. Returns the task id, status, output URLs, and pricing snapshot. |
create_mashup | Yes | Create a Suno create mashup task and optionally wait for a terminal status. Returns the task id, status, output URLs, and pricing snapshot. |
extend_music | Yes | Create a Suno extend music task and optionally wait for a terminal status. Returns the task id, status, output URLs, and pricing snapshot. |
generate_lyrics | Yes | Create a Suno generate lyrics task and optionally wait for a terminal status. Returns the task id, status, output URLs, and pricing snapshot. |
text_to_music | Yes | Create a Suno text to music task and optionally wait for a terminal status. Returns the task id, status, output URLs, and pricing snapshot. |
text_to_sound | Yes | Create a Suno text to sound task and optionally wait for a terminal status. Returns the task id, status, output URLs, and pricing snapshot. |
get_task | Yes | Fetch the current status and latest payload for an existing task. |
check_pricing | No | Look up the current pricing snapshot for a Suno model and endpoint. |
Suno covers 6 model variants across 6 endpoints. Each tool accepts the models listed for it:
| Tool | Models |
|---|---|
cover_audio | suno-v4, suno-v4.5, `suno-v4.5- |