How do I install SunoBoard?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does SunoBoard need an API key?

No required environment variable is listed on this record.

What transport does SunoBoard use?

SunoBoard is reached over HTTP.

When was SunoBoard last checked?

Last checked 2026-11-08. AI music and sound effects for games and videos: Suno, Lyria, Stable Audio, MiniMax, ElevenLabs.

SunoBoard MCP server

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

https://mcp.sunoboard.com/mcp

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

1claude mcp add --transport http com.sunoboard-sunoboard https://mcp.sunoboard.com/mcp

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "com.sunoboard-sunoboard": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://mcp.sunoboard.com/mcp"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Remote

Transport: http
Version: 1.0.0
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

@yellowkode/suno-mcp

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

by YellowKode Academy · 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:

Option	Key format	Where to get
SunoBoard (recommended)	`sb_...`	sunoboard.com — generations saved to your dashboard
sunoapi.org (BYOK)	`abc123...`	sunoapi.org → Dashboard → API Keys

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

Tool	Description
`generate_music`	Start music generation — returns a `taskId`
`get_music_status`	Check generation status by `taskId`
`wait_for_music`	Auto-poll until ready, returns audio URL (up to 5 min)
`list_recent_music`	List recently generated tracks
`get_credits`	Check remaining API credits

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

Tool	Description
`generate_sfx`	Generate a sound effect from text (footsteps, coins, doors, UI clicks, whooshes…), 0.5–10 s, ready in ~2 s. Pass `public: true` to also share it on SunoBoard Discover
`list_models`	Music and SFX models (Suno, Google Lyria, MiniMax, Stable Audio, ElevenLabs, TangoFlux) with what each costs
`get_usage`	Credits and sound effects left this month, reset date, your default models
`search_library`	Search the public SunoBoard library of ready-made tracks (free)
`get_referral_link`	Your referral link (bonus credits for you and a friend)

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

Parameter	Type	Default	Description
`prompt`	string	required	Music description or lyrics (in custom mode)
`model`	string	`V4_5`	`V4` · `V4_5` · `V4_5PLUS` · `V4_5ALL` · `V5` · `V5_5`
`style`	string	—	Style tags e.g. `"ambient dark, slow drums"`
`title`	string	—	Track title (required in custom mode)
`instrumental`	boolean	`false`	Generate without vocals
`customMode`	boolean	`false`	Use `prompt` as literal lyrics
`vocalGender`	`"male"` \| `"female"`	—	Vocal preference (custom mode only)
`negativeTags`	string	—	Styles to avoid e.g. `"heavy metal"`
`styleWeight`	0–1	`0.5`	Style adherence
`weirdnessConstraint`	0–1	`0.5`	Creativity vs. predictability
`audioWeight`	0–1	`0.5`	Audio quality weight

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

Variable	Required	Default	Description
`SUNO_API_KEY`	✅	—	Your API key (`sb_...` or sunoapi.org hash)
`SUNO_API_BASE_URL`	❌	auto-detected	Override API base URL
`MAX_POLL_ATTEMPTS`	❌	`30`	Max polls for `wait_for_music`
`POLL_INTERVAL_MS`	❌	`10000`	Polling interval in ms

Visual Dashboard

Want to manage all your generated music visually?

SunoBoard 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

Built with ❤️ by Kelvin Biffi

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install SunoBoard?

Does SunoBoard need an API key?

What transport does SunoBoard use?

When was SunoBoard last checked?

Documentation

@yellowkode/suno-mcp

What is this?

Prerequisites

Quick start

Setup

Claude Desktop

Claude Code (terminal)

Cursor / Cline (VSCode)

Available Tools

generate_music parameters

Usage Examples

Basic

Game development

Sound effects for your game (SunoBoard key)

Custom lyrics

With full control

Environment Variables

Visual Dashboard

Contributing

License

`generate_music` parameters