Skip to content
MCP server

WaveForge

Turn a track and cover art into an audio-reactive music video via API or MCP

Install
Pricing
Freemium
Platforms
API, Web
Runs
Remotely
Version
1.0.1
Listing updated
2 days ago

About WaveForge

WaveForge is a freemium MCP server for design and media. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://waveforge.net/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "waveforge": {
      "url": "https://waveforge.net/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Freemium

Free test keys and previews; live renders use credits; prices not published

Prices change. Check waveforge.net before you buy.

WaveForge 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 to WaveForge

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  4. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media