MCP Server Guide

Use Suno V5.5 from Claude Code

Suno V5.5 is the latest Suno music generation model and AetherWave's default for music. Returns two tracks per submission (a pair with shared style but distinct arrangements). Supports both lyrical and instrumental output, plus custom lyrics.

If you use Claude Code and you want Suno V5.5 available as a native tool that the agent can call directly, the AetherWave MCP server wires it up in one command. No SDK to learn, no separate API key per provider, no polling loop to write.

Install in 30 seconds

Run this from your terminal:

claude mcp add aetherwave \
-e AETHERWAVE_API_KEY=aw_live_your_key_here \
-- npx -y @aetherwave-studio/mcp

Get your API key at your Profile page under the Developer tab. New accounts start with free credits to try it without spending anything.

Quick facts

Model ID
V5_5
Provider
Suno
Cost
12 cr per submission
Outputs per call
2

How to use it

Once the MCP is installed, you can ask Claude Code naturally. It'll pick Suno V5.5 from the model-selection rubric in the tool description when your prompt matches its strengths (premium AI music generation).

Example interaction:

You
Generate original music for music videos, podcasts, content backgrounds

Claude Code calls aetherwave_generate_music with model: "V5_5" and returns the finished asset URL. The result auto-saves to your AetherWave gallery (Cloudflare R2 hosted, no URL expiration).

Sample prompts that work well

Example 1
"Synthwave instrumental with slow driving arpeggios, lush reverb-soaked pads, distant gated drums, dreamy analog lead - nostalgic, slow"
Example 2
"Upbeat indie pop with bright acoustic guitar, hand claps, and warm summer vibe - high-energy chorus, instrumental"
Example 3
"Lo-fi hip hop with vinyl crackle, mellow Rhodes chord cycles, soft bass pulses, head-nod tempo - cozy and warm"

When to pick Suno V5.5

Suno V5.5 shines for:

How it compares

vs Suno V5: V5.5 is the newer version with improved coherence and arrangement. V5 still available via the model param. Both return 2 tracks per submission.

Run aetherwave_list_master_preset_models from Claude Code to see the full live catalog with pricing.

Cost

Flat 12 credits per generation. Returns 2 tracks per call (~6 cr/track effective). Suno V5.5 is the newest and highest-quality Suno model version.

Credits come from your AetherWave account. Plans:

Frequently Asked Questions

How do I install AetherWave MCP in Claude Code?

One command (shown above). Then restart Claude Code. The agent will have Suno V5.5 available as part of the aetherwave_generate_music tool with 2 output(s) per call.

How do I use Suno V5.5 from Claude Code?

Just describe what you want. The agent picks Suno V5.5 when your prompt matches its strengths (premium AI music generation). You can also explicitly request it by passing model: "V5_5" in the tool call.

What does Suno V5.5 cost per generation?

Flat 12 credits per generation. Returns 2 tracks per call (~6 cr/track effective). Suno V5.5 is the newest and highest-quality Suno model version. Credits come from your AetherWave account (Studio sub from $9.99/mo or one-time bundles from $4.99/500 cr).

Try Suno V5.5 from Claude Code

Free API key, free starter credits, single MCP install. Be running your first Suno V5.5 generation in under five minutes.

Get Your Free API Key