MCP Setup Guide

AetherWave MCP for Cursor

Cursor is an AI-first code editor with built-in MCP support. Drop one server block into your Cursor MCP config and the editor's agent can generate album art, b-roll, sound, or full tracks as part of whatever you are building.

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 Cursor 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
Cursor
Config location
~/.cursor/mcp.json (or .cursor/mcp.json per project)
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 Cursor

Add this block to ~/.cursor/mcp.json (or .cursor/mcp.json per project):

{
"mcpServers": {
"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 Cursor.

Step 3: Generate

Restart Cursor 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.

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

Use a project-level .cursor/mcp.json to scope AetherWave to a single repo, or the global ~/.cursor/mcp.json to make it available everywhere. After saving, reload Cursor and the tools appear in the MCP panel.

Frequently Asked Questions

Does AetherWave MCP work with Cursor?

Yes. Cursor has native MCP support. Add the AetherWave server block to your Cursor mcp.json and reload; all 16 tools become available to the agent.

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

Yes, a free API key. Paste your aw_live_ key into the env block of the server config. New accounts include free starter credits.

What can I generate from Cursor 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 Cursor today

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

Get Your Free API Key