AetherWave MCP for Windsurf

Windsurf (by Codeium) runs the Cascade agent with MCP support. Add AetherWave to your Windsurf MCP config and Cascade can call generation tools mid-flow, turning a coding session into one that also produces the media your project needs.

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 Windsurf 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 Windsurf

Add this block to ~/.codeium/windsurf/mcp_config.json:

Replace aw_live_your_key_here with your real key, save, and reload Windsurf.

Step 3: Generate

Restart Windsurf and ask it to make something. For example:

Windsurf 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 Windsurf

Open the Windsurf MCP settings, add the AetherWave server block, then click refresh in the Cascade MCP panel. The 16 tools load without a full restart.

Frequently Asked Questions

Does AetherWave MCP work with Windsurf?

Yes. Windsurf's Cascade agent supports MCP servers. Add the AetherWave block to mcp_config.json and refresh the MCP panel.

Do I need an API key to use AetherWave in Windsurf?

Yes, a free API key goes in the env block. Free starter credits are included on signup so you can test immediately.

What can I generate from Windsurf 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.