AetherWave MCP for Claude Code

Claude Code is Anthropic's agentic coding tool, and it has first-class MCP support through the claude mcp add command. That makes AetherWave one of the fastest integrations there is: a single line in your terminal and the agent can generate music, images, and video without you writing a single API call.

The AetherWave MCP server exposes 16 generation tools (music via Suno, image generation and editing, video generation, upscaling, background removal, reframing, and audio mastering) as native tools your agent in Claude Code can call. No SDK, no per-provider API keys, no polling loops to write. Every generation auto-saves to your AetherWave gallery on Cloudflare R2.

Quick facts

Step 1: Get your API key

Create a free AetherWave account and copy your API key (starts with aw_live_) from the Developer tab on your Profile page. New accounts get free starter credits, so you can test without spending anything.

Step 2: Add AetherWave to Claude Code

Run this once from your terminal:

That registers the server. Restart Claude Code and the 16 AetherWave tools are available to the agent.

Step 3: Generate

Restart Claude Code and ask it to make something. For example:

Claude Code calls aetherwave_generate_music and aetherwave_generate_image in sequence and hands back finished, hosted URLs. You can check your balance any time with aetherwave_balance.

Notes for Claude Code

Claude Code also supports the remote OAuth connector if you would rather not manage a key locally: run claude mcp add --transport http aetherwave https://mcp.aetherwavestudio.com/mcp and approve the one-time browser consent. Either path gives you the same 16 tools.

Frequently Asked Questions

Does AetherWave MCP work with Claude Code?

Yes. Claude Code has native MCP support via the claude mcp add command, so AetherWave installs in one line and every tool shows up immediately after a restart.

Do I need an API key to use AetherWave in Claude Code?

You can use either an API key (passed with -e AETHERWAVE_API_KEY) or the remote OAuth connector (one-click browser consent, no key to manage). Both bill to the same AetherWave account.

What can I generate from Claude Code with AetherWave?

All 16 AetherWave tools are available: AI music, image generation and editing, video generation, upscaling, background removal, reframing, and audio mastering. Every call draws on your own AetherWave credits, and results save to your gallery automatically.