# aetherwave-mcp

Connects music, image, and video generation models through one unified API key. Useful for drafting and processing creative media directly inside your AI coding assistant.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6
- Author: AetherWave-Studio
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/AetherWave-Studio/aetherwave-mcp
- Updated: 2026-10-05
- HTML: https://affpapa.org/en/nevibecode/mcp/aetherwave-mcp

## What it does

The server exposes creative generation pipelines to your assistant over standard stdio JSON-RPC. Through a single `AETHERWAVE_API_KEY`, an agent can produce Suno music tracks, synthesize pictures, edit footage, and run audio mastering presets. Media assets automatically land in Cloudflare R2 storage, preventing generated asset links from expiring.

Requests hold for up to 45 seconds before timing out into the background. When generation takes longer, the server responds with a `running` state alongside a `taskId`. The agent tracks in-flight rendering by polling `aetherwave_get_job`, or you can trigger operations immediately by setting `async: true`.

Uploading user media caps out at 95 MB per file. If you plan to manage apparel mockups and storefront products, the server demands an additional `PRINTFUL_API_TOKEN` to talk to Printful endpoints.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `AETHERWAVE_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add aetherwave-mcp -e AETHERWAVE_API_KEY=<AETHERWAVE_API_KEY> -- npx -y @aetherwave-studio/mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add aetherwave-mcp --env AETHERWAVE_API_KEY=<AETHERWAVE_API_KEY> -- npx -y @aetherwave-studio/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "aetherwave-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@aetherwave-studio/mcp"
            ],
            "env": {
                "AETHERWAVE_API_KEY": "<AETHERWAVE_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "aetherwave-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@aetherwave-studio/mcp"
            ],
            "env": {
                "AETHERWAVE_API_KEY": "<AETHERWAVE_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e AETHERWAVE_API_KEY=<AETHERWAVE_API_KEY> aetherwave-mcp npx -y @aetherwave-studio/mcp
```
Replace <…> with your own values

## When to use it
- synthesize instrumental songs and vocal tracks with Suno
- build graphic novel pages with scripts and character sheets
- upscale pictures and video clips to higher resolutions
- extract backgrounds from photos and video frames
- apply mastering presets to completed audio files

## Example prompts
- Generate a synthwave album cover and create a video animation from it
- Produce an instrumental rock track with Suno and check its status
- Remove the background from `clip.mp4` and export it as transparent WebM

## Similar
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16730
- [labelhead-artist-momentum](https://affpapa.org/en/nevibecode/mcp/labelhead-artist-momentum.md) — MCP server · ★ 107701
- [Agent Skills Search Server](https://affpapa.org/en/nevibecode/mcp/agent-skills-search-server.md) — MCP server · ★ 26673
- [Skyvern](https://affpapa.org/en/nevibecode/mcp/skyvern.md) — MCP server · ★ 23283
- [Nhost](https://affpapa.org/en/nevibecode/mcp/nhost.md) — MCP server · ★ 9369
- [PraisonAI](https://affpapa.org/en/nevibecode/mcp/praisonai.md) — MCP server · ★ 9298

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md