Skip to content
MCP server

WaveSpeed

Run any WaveSpeed image, video, audio or 3D model from an MCP client, quoting price first

Install
Pricing
Paid
Platforms
API, CLI
Runs
Locally or Remotely
Version
1.2.15
Listing updated
3 days ago

About WaveSpeed

WaveSpeed is a paid MCP server for design and media. It can run locally on your machine or as a hosted remote server.

This server follows the live WaveSpeed catalog rather than a fixed list: list_models searches it, get_model_schema shows the exact inputs a model accepts, and run_model submits a job, rejecting keys the model does not take. A @path marker inside inputs uploads a local file and swaps in its hosted URL. The catalog is cached for an hour, so newly released models work the day they ship.

Five shortcut tools (generate_image, edit_image, generate_video, edit_video, extend_video) pick an endpoint for what you supply and fit the request to the model's live schema, defaulting to Seedream 5.5 for images and Seedance 2.5 for video. They report any changes in notes and can return a price estimate without submitting anything.

Long generations can take minutes to hours, so run_model returns a prediction id and the assistant polls get_prediction; the task keeps running server-side. Account tools show credit balance, run history, itemized billing and usage, and a delete tool clears finished runs after confirmation. It runs over stdio with an API key or as a remote endpoint at api.wavespeed.ai/mcp.

Install

Run in a terminal

claude mcp add --transport http mcp https://api.wavespeed.ai/mcp

Add to Settings → Connectors → Add custom connector

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://api.wavespeed.ai/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://api.wavespeed.ai/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://api.wavespeed.ai/mcp"
    }
  }
}

Configuration

  • WAVESPEED_API_KEYWaveSpeed API key (https://wavespeed.ai/accesskey). Optional when the wavespeed CLI is logged in.
  • WAVESPEED_BASE_URLOverride the WaveSpeed API base URL. Defaults to https://api.wavespeed.ai.
  • WAVESPEED_CLIENT_NAMEOverride the client name reported for channel attribution. Defaults to wavespeed-mcp.

Tools this server provides (16)

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

list_models
Search the live catalog by text or modality
get_model_schema
A model's real input schema
run_model
Submit a model run and return output URLs
generate_image
Image from a prompt
edit_image
Edit, restyle or combine images
generate_video
Video from a prompt, frames or references
edit_video
Edit an existing video
extend_video
Continue an existing video
get_price
Cost estimate with no charge
get_balance
Account credit balance
list_predictions
Run history
list_billings
Itemized charges and refunds
get_usage
Spend and request counts
delete_predictions
Delete finished runs
upload_file
Local file to hosted URL
get_prediction
Status and outputs of a run

What it does

Live model catalog
Search and call any current model without a hardcoded list.
Schema before running
Read a model's real input schema, then submit matching input.
Price quotes
Estimate cost for the same input before spending.
Image and video shortcuts
Generate, edit and extend media with defaults picked for you.
Long-running jobs
Submit and poll by prediction id without losing work on disconnect.
Usage and billing views
Check balance, history, itemized charges and spend.

Good for

  • Generate an image from a prompt inside Claude Code
  • Edit or restyle existing pictures with a chosen model
  • Extend or edit a video clip
  • Quote the cost of a render before running it
  • Review last week's spend per model

Pricing

Paid

Pay-per-use credits; eligible new accounts get $1 free credit

Prices change. Check wavespeed.ai before you buy.

WaveSpeed FAQ

Do I need an API key?

An API key is needed, though it is optional when the wavespeed CLI is already logged in.

How is it priced?

WaveSpeed is pay-per-use with no monthly fee, and eligible new accounts get $1 in free credits.

Can I preview cost?

Yes. `get_price` and `estimate_only` return an estimate without charging.

Is there a remote option?

Yes, a Streamable HTTP endpoint at https://api.wavespeed.ai/mcp.

Is WaveSpeed free?

No. WaveSpeed is a paid product.

How do I add WaveSpeed to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://api.wavespeed.ai/mcp

What are the best alternatives to WaveSpeed?

The closest alternatives to WaveSpeed are HyperFrames by HeyGen, ffmpeg-skill, Claude Code Ultimate Guide, AvatarSay — Fictional Character & Talking Video MCP and ChartAnt.

Alternatives to WaveSpeed

  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. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  4. ChartAnt

    MCP server

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

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  5. 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