MCPSuno MCP Server

1

Add it to Claude Code

Run this in a terminal.

Run in terminal
claude mcp add --transport http -H "Authorization: Bearer YOUR_API_TOKEN" mcp-suno https://suno.mcp.acedata.cloud/mcp
Required:Authorization
README.md

AI music generation with Suno through the AceDataCloud API

MCP Suno

A Model Context Protocol (MCP) server for AI music generation using Suno through the AceDataCloud API.

Generate AI music, lyrics, and manage audio projects directly from Claude, VS Code, or any MCP-compatible client.

Features

  • Music Generation - Create AI-generated songs from text prompts
  • Custom Lyrics & Style - Full control over lyrics, title, and music style
  • Song Extension - Continue existing songs from any timestamp
  • Cover/Remix - Create cover versions with different styles
  • Lyrics Generation - Generate structured lyrics from descriptions
  • Persona Management - Save and reuse voice styles
  • Task Tracking - Monitor generation progress and retrieve results

Quick Start

1. Get Your API Token

  1. Sign up at AceDataCloud Platform
  2. Go to the API documentation page
  3. Click "Acquire" to get your API token
  4. Copy the token for use below

2. Use the Hosted Server (Recommended)

AceDataCloud hosts a managed MCP server — no local installation required.

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

All requests require a Bearer token. Use the API token from Step 1.

Claude.ai

Connect directly on Claude.ai with OAuth — no API token needed:

  1. Go to Claude.ai Settings → Integrations → Add More
  2. Enter the server URL: https://suno.mcp.acedata.cloud/mcp
  3. Complete the OAuth login flow
  4. Start using the tools in your conversation
Claude Desktop

Add to your config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "suno": {
      "type": "streamable-http",
      "url": "https://suno.mcp.acedata.cloud/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}
Cursor / Windsurf

Add to your MCP config (.cursor/mcp.json or .windsurf/mcp.json):

{
  "mcpServers": {
    "suno": {
      "type": "streamable-http",
      "url": "https://suno.mcp.acedata.cloud/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}
VS Code (Copilot)

Add to your VS Code MCP config (.vscode/mcp.json):

{
  "servers": {
    "suno": {
      "type": "streamable-http",
      "url": "https://suno.mcp.acedata.cloud/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Or install the Ace Data Cloud MCP extension for VS Code, which bundles all 11 MCP servers with one-click setup.

JetBrains IDEs
  1. Go to Settings → Tools → AI Assistant → Model Context Protocol (MCP)
  2. Click AddHTTP
  3. Paste:
{
  "mcpServers": {
    "suno": {
      "url": "https://suno.mcp.acedata.cloud/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}
Claude Code

Claude Code supports MCP servers natively:

claude mcp add suno --transport http https://suno.mcp.acedata.cloud/mcp \
  -h "Authorization: Bearer YOUR_API_TOKEN"

Or add to your project's .mcp.json:

{
  "mcpServers": {
    "suno": {
      "type": "streamable-http",
      "url": "https://suno.mcp.acedata.cloud/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}
Cline

Add to Cline's MCP settings (.cline/mcp_settings.json):

{
  "mcpServers": {
    "suno": {
      "type": "streamable-http",
      "url": "https://suno.mcp.acedata.cloud/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}
Amazon Q Developer

Add to your MCP configuration:

{
  "mcpServers": {
    "suno": {
      "type": "streamable-http",
      "url": "https://suno.mcp.acedata.cloud/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}
Roo Code

Add to Roo Code MCP settings:

{
  "mcpServers": {
    "suno": {
      "type": "streamable-http",
      "url": "https://suno.mcp.acedata.cloud/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}
Continue.dev

Add t

Tools (5)

generate_musicCreate AI-generated songs from text prompts
generate_lyricsGenerate structured lyrics from descriptions
extend_songContinue existing songs from any timestamp
create_coverCreate cover versions with different styles
get_task_statusMonitor generation progress and retrieve results

Environment Variables

AuthorizationrequiredBearer token obtained from AceDataCloud platform

Configuration

claude_desktop_config.json
{"mcpServers": {"suno": {"type": "streamable-http", "url": "https://suno.mcp.acedata.cloud/mcp", "headers": {"Authorization": "Bearer YOUR_API_TOKEN"}}}}

Try it

Generate a upbeat pop song about coding in Python with a catchy chorus.
Write lyrics for a melancholic jazz song about a rainy city.
Extend my previous song clip starting from the 30-second mark.
Create a heavy metal cover version of the song with ID 12345.
Check the status of my music generation task with ID 67890.

Frequently Asked Questions

What are the key features of MCPSuno?

Music Generation from text prompts. Custom lyrics and music style control. Song extension from specific timestamps. Cover and remix creation. Task tracking for generation progress.

What can I use MCPSuno for?

Rapid prototyping of song ideas for music producers. Generating background music for content creators. Creating custom voice styles and personas for audio projects. Automating the creation of song lyrics based on specific themes.

How do I install MCPSuno?

Install MCPSuno by running: Add to ~/Library/Application Support/Claude/claude_desktop_config.json

What MCP clients work with MCPSuno?

MCPSuno works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep MCPSuno docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare