MCP Setup Guide

AetherWave MCP for VS Code

VS Code supports MCP servers natively for agent mode in GitHub Copilot Chat. Add AetherWave to your workspace MCP config and Copilot's agent can generate music, images, and video alongside your code.

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

Client
VS Code
Config location
.vscode/mcp.json (workspace) or user settings
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 VS Code

Add this block to .vscode/mcp.json (workspace) or user settings:

{
"servers": {
"aetherwave": {
"command": "npx",
"args": ["-y", "@aetherwave-studio/mcp"],
"env": { "AETHERWAVE_API_KEY": "aw_live_your_key_here" }
}
}
}

Replace aw_live_your_key_here with your real key, save, and reload VS Code.

Step 3: Generate

Restart VS Code 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.

VS 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 VS Code

VS Code's native MCP config uses a servers key (not mcpServers). Create .vscode/mcp.json in your workspace with the block below, then enable the server in the MCP view. Agent mode in Copilot Chat will list the AetherWave tools.

Frequently Asked Questions

Does AetherWave MCP work with VS Code?

Yes. VS Code supports MCP servers for Copilot agent mode. Add AetherWave to .vscode/mcp.json (note the servers key) and enable it.

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

Yes, a free API key in the env block. Free starter credits are included on signup.

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

Use AetherWave in VS Code today

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

Get Your Free API Key