# WaveForge

> WaveForge is a freemium MCP server for design and media. Turn a track and cover art into an audio-reactive music video via API or MCP. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, Web
- **Website:** https://waveforge.net/developers
- **MCP Registry name:** net.waveforge/waveforge
- **Categories:** design and media
- **Listing updated:** 2026-11-15

## About

WaveForge renders music visualizer videos, and its MCP server gives agents the same controls as its REST API v1. One key works across the REST API, a one-shot preview endpoint called the Agent Door, and the MCP connector.

The MCP tools are list_presets, list_export_formats, create_render, get_render_status, list_renders and get_render_output. A render takes an audio file or URL, cover art, title and artist, a visualizer preset and a format of landscape, vertical, square or canvas. Signed webhooks report render events.

Keys starting wf_test_ are free and never charge or encode, while wf_live_ keys run real renders and use credits. The Agent Door queues a watermarked 720p preview trimmed to 60 seconds from a public audio URL, free, at 5 previews per key per day. Callers must attest they have rights to the audio. The bearer key is required, and free accounts include one key.

## Features

- **Render queue:** Creates, lists and polls video renders and fetches the finished file.
- **Visualizer presets:** Lists the available visualizer engines to choose from.
- **Four formats:** Supports landscape, vertical, square and canvas outputs.
- **Free preview:** Queues a watermarked 720p preview up to 60 seconds long.
- **Test keys:** wf_test_ keys exercise the API without charges or encoding.

## Good for

- Make a vertical music video for a new single
- Generate a quick watermarked preview from a track URL
- Let an assistant poll render status and fetch output
- Batch videos through the REST API and webhooks

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http waveforge https://waveforge.net/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://waveforge.net/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "waveforge": {
      "url": "https://waveforge.net/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "waveforge": {
      "type": "http",
      "url": "https://waveforge.net/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "waveforge": {
      "serverUrl": "https://waveforge.net/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "waveforge": {
      "type": "http",
      "url": "https://waveforge.net/mcp"
    }
  }
}
```

## Tools

- `list_presets`: Lists the available visualizer presets.
- `list_export_formats`: Lists the supported export formats.
- `create_render`: Queues a render from audio and cover art.
- `get_render_status`: Returns the status of a queued render.
- `list_renders`: Lists the account's renders.
- `get_render_output`: Fetches the finished file of a render.

## FAQ

### Is there a free way to try it?

Yes. Test keys never charge, and the Agent Door gives free watermarked previews, 5 per key per day.

### Which clients can connect?

The page lists ChatGPT connectors, Claude, Cursor, Windsurf, Cline, Continue, Zed and Raycast, among others.

### What do I send to render?

An audio file or URL, an image, a preset and a format, plus title and artist.

### Is WaveForge free?

WaveForge has a free plan, with paid plans for more usage or features.

### How do I add WaveForge to Claude Code?

Run this command in your terminal: claude mcp add --transport http waveforge https://waveforge.net/mcp

### What are the best alternatives to WaveForge?

The closest alternatives to WaveForge are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/waveforge
