SunoBoard

@yellowkode/suno-mcp

MCP Server for Suno AI — Generate music directly from Claude, VSCode, Cursor, and any MCP-compatible client.

by [YellowKode Academy](https://yellowkode.com) · sunoboard.com

---

What is this?

@yellowkode/suno-mcp is an open-source Model Context Protocol (MCP) server that connects Claude and other AI assistants directly to the Suno AI music generation API.

Instead of manually calling the API, you can just tell Claude:

*"Generate a dark ambient viking instrumental, slow drums, cinematic, no vocals"*

...and Claude handles the full generation flow automatically.

---

Prerequisites

• Node.js 18+
• A Suno API key — two options:

The server auto-detects which API to use based on the key prefix. No extra config needed.

---

Quick start

# One-shot (no install needed)

SUNO_API_KEY=your_key npx @yellowkode/suno-mcp

Or install globally

npm install -g @yellowkode/suno-mcp

---

Setup

Claude Desktop

Edit claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{

"mcpServers": { "suno": { "command": "npx", "args": ["@yellowkode/suno-mcp"], "env": { "SUNO_API_KEY": "your_key_here" } } } }

Claude Code (terminal)

claude mcp add suno \

-e SUNO_API_KEY=your_key_here \ -- npx @yellowkode/suno-mcp

Cursor / Cline (VSCode)

Add to .cursor/mcp.json or .vscode/mcp.json:

{

"mcpServers": { "suno": { "command": "npx", "args": ["@yellowkode/suno-mcp"], "env": { "SUNO_API_KEY": "your_key_here" } } } }

---

Available Tools

With a SunoBoard key (`sb_...`) you also get:

With a SunoBoard key, generate_music also accepts model = lyria-3-pro, minimax-2.6, stable-audio-2.5 or elevenlabs-music (plus duration_seconds where supported). Get your key at sunoboard.com/settings — or skip the install and add the hosted connector https://mcp.sunoboard.com/mcp (guide).

generate_music parameters

---

Usage Examples

Basic

*"Generate a relaxing lo-fi hip hop track for studying"*

Claude calls generate_music → wait_for_music and returns the audio URL.

Game development

*"Generate dramatic battle music for an RPG boss fight, orchestral, no lyrics, intense"*

Sound effects for your game (SunoBoard key)

*"Here's my list of 20 sounds (footsteps on grass, coin pickup, door creak…). Generate each one with generate_sfx and save them to assets/audio/sfx"*

Custom lyrics

*"Generate a song with these lyrics: [paste lyrics], style: indie pop, female vocals"*

With full control

*"Generate music: prompt='cosmic meditation', style='deep space ambient, synth pads', model=V5, instrumental, weirdness=0.7"*

---

Environment Variables

---

Visual Dashboard

Want to manage all your generated music visually?

[SunoBoard](https://sunoboard.com) gives you:

• Full history with inline player
• Organize by project (e.g. "Game OST", "YouTube Channel")
• Download MP3
• Credit tracking
• Regenerate with same parameters

Use a sb_ key to have all generations appear automatically in your dashboard.

---

Contributing

git clone https://github.com/YellowKode-Academy/suno-mcp

cd suno-mcp npm install npm run dev

Tests: npm test

---

License

MIT © YellowKode Academy · Wunka Tech

*Built with ❤️ by Kelvin Biffi*