Log inSubmit server
Aetherwave MCP logo

Aetherwave MCP

by AetherWave-Studio

Generate and transform music, images, video, and audio through one MCP connection, API key, and shared credit balance.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Aetherwave MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "aetherwave-studio-aetherwave-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@aetherwave-studio/mcp"
      ],
      "env": {
        "AETHERWAVE_API_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y @aetherwave-studio/mcp

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 1mo ago.

Overview

AetherWave-Studio/aetherwave-mcp MCP server exposes AetherWave Studio’s creative generation and media-processing API through standard MCP tools. It supports music, image, video, and audio mastering workflows, including generation, editing, upscaling, reframing, and background removal. Generation jobs are submitted and polled by the server, which returns final URLs and saves results to an AetherWave gallery. Reach for it when an agent needs access to multiple creative AI model families without configuring each provider separately.

Use cases

  • Generate concept images and animate them into short videos
  • Create vocal or instrumental Suno music tracks
  • Upscale and reframe media for different output formats
  • Remove backgrounds from images and video
  • Master audio using genre-specific presets

Key features

  • Unified image, video, music, and audio generation
  • Image and video editing utilities
  • Automatic job polling and final URL return
  • Shared credit balance with balance lookup
  • Paginated creation gallery for chained workflows
  • Model and mastering preset discovery

Tools29

What Aetherwave MCP lets your agent do. Expand a tool for its parameters.

Self-reported~736 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

18/18 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 8d ago via OSV.dev · @aetherwave-studio/mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars6Stargazers on the source repository.
npm downloads531Package downloads in the last 30 days.
Last commit22d agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Tools exposed29Callable tools this server registers over MCP.
Directory activity7 viewsConfig copies, upvotes, and views on AllMCPs.

How Aetherwave MCP works

What AetherWave-Studio/aetherwave-mcp MCP server does

AetherWave-Studio/aetherwave-mcp MCP server connects MCP-compatible clients to AetherWave Studio’s unified creative API. It provides tools for generating music, images, and video, along with utilities for editing, upscaling, reframing, background removal, and audio mastering. The service groups these operations behind one API token and one credit balance rather than exposing separate credentials for each listed model provider.

Image generation supports text-to-image and image-to-image workflows across models including Grok Imagine, GPT Image 2, Seedream, Wan, Imagen, Nano Banana, Ideogram, and Z-Image Turbo. Video generation supports text-to-video and image-to-video across model families such as Grok Imagine, Wan, Hailuo, Seedance, Kling, VEO, and Happy Horse. Music generation uses Suno models and can produce vocal or instrumental tracks.

How it works

A client invokes an MCP tool with the requested prompt, source URL, model, and optional output settings. For generation operations, AetherWave submits the job, waits for a terminal result, and returns the resulting media URL instead of requiring the agent to implement its own polling loop. Video jobs can be polled for up to eight minutes according to the tool reference.

Generated results are automatically saved to the AetherWave Cloudflare R2 gallery. The aetherwave_list_my_creations tool provides a paginated read of that gallery, which supports workflows that pass earlier outputs into later operations. Video generation can use a KIE and fal fallback for the default Grok Imagine path, while background removal also has a documented fallback provider.

Setup and configuration

The package runs as a local stdio MCP server. Install or launch it with:

Terminal
npx -y @aetherwave-studio/mcp

Set AETHERWAVE_API_KEY to a developer key obtained from the AetherWave Studio profile’s Developer tab. The same environment variable can be placed in an MCP client configuration. The README gives configurations for Claude Code, Claude Desktop, Cursor, Continue, and custom JSON-RPC clients that communicate over stdio.

The first key includes free credits and does not require a card, but operations consume credits according to the selected model and operation. The balance and current plan are available through aetherwave_balance.

Tools and capabilities

The tool surface includes:

  • Listing image models, video models, and audio-mastering presets with pricing or model metadata.
  • Generating images with aspect ratio, resolution, reference image, output-count, seed, and optional negative-prompt controls.
  • Editing an image from a public source URL using a text instruction.
  • Upscaling images by 1x, 2x, 4x, or 8x, and upscaling video to 1080p or 2K.
  • Reframing images or video to a new aspect ratio.
  • Removing image backgrounds with automatic fallback behavior, or removing video backgrounds frame by frame into transparent WebM or a solid-color output.
  • Generating two Suno tracks per music submission, with optional custom lyrics, titles, and instrumental mode.
  • Mastering audio with twelve genre or style presets; the documented cost is 20 credits per track, with mastering free on Producer, Mogul, and Ultimate plans.

Limitations and notes

Model availability, supported resolutions, durations, aspect ratios, and credit costs vary by model. Some image-to-image and image-to-video operations require a public source image URL. Video duration ranges from two to thirty seconds at the tool level, while individual models may support narrower ranges. The default image, video, music, and image-edit models are selected automatically, but agents can request specific model IDs.

AetherWave-Studio/aetherwave-mcp MCP server requires an AetherWave API key and an available credit balance for paid operations.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Aetherwave MCP

Run `npx -y @aetherwave-studio/mcp` and configure `AETHERWAVE_API_KEY` in your MCP client.

Yes. The README provides Claude Desktop configuration using the `npx` command and `AETHERWAVE_API_KEY`.

It can generate images, videos, and Suno music, and it can master audio using twelve listed presets.

Yes. Set `AETHERWAVE_API_KEY` to an AetherWave Studio developer key.

Related MCP servers

All in Multimedia Process All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewAetherwave MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/aetherwave-studio-aetherwave-mcp?style=directory)](https://allmcps.com/mcp/aetherwave-studio-aetherwave-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/aetherwave-studio-aetherwave-mcp"><img src="https://allmcps.com/api/badge/aetherwave-studio-aetherwave-mcp?style=directory" alt="Aetherwave MCP on AllMCPs" /></a>