MCP Setup Guide

AetherWave MCP for Goose

Goose, the open-source agent from Block, treats MCP servers as extensions. Add AetherWave and Goose can call generation tools as part of any automated workflow it runs for you.

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

Client
Goose
Config location
goose configure > Add Extension > Command-line
Auth
API key
Tools available
16 (music, image, video, audio)

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 Goose

Add AetherWave from the command line:

goose configure

Step 3: Generate

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

You
Generate a lofi hip hop track for a study playlist, then make album art for it.

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

Run goose configure, choose Add Extension, then Command-line Extension. Use npx -y @aetherwave-studio/mcp as the command and add AETHERWAVE_API_KEY as an environment variable. Goose loads the 16 tools on its next run.

Frequently Asked Questions

Does AetherWave MCP work with Goose?

Yes. Goose loads MCP servers as extensions. Add AetherWave through goose configure as a command-line extension.

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

Yes, a free API key, set as the AETHERWAVE_API_KEY environment variable on the extension. New accounts get free starter credits.

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

Use AetherWave in Goose today

Free API key, free starter credits, one setup. Be generating music, images, and video from Goose in under five minutes.

Get Your Free API Key