WaveSpeed
Run any WaveSpeed image, video, audio or 3D model from an MCP client, quoting price first
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://api.wavespeed.ai/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"url": "https://api.wavespeed.ai/mcp"
}
}
}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

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

ffmpeg-skill
MCP serverLocal FFmpeg video and audio editing tools for coding agents over MCP
Runs locally- Open source
- 6.9K GitHub stars
- Design and media

Claude Code Ultimate Guide
MCP serverMCP 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

Generate fictional character portraits and lip-synced talking videos from text over MCP
- 10 tools
- Remote
- Freemium
- Design and media

ChartAnt
MCP serverRemote MCP server returning charts, maps and dashboards as hosted PNG links
- 51 tools
- Remote
- Freemium
- Design and media

VfxSmith
MCP serverSearch, generate, refine and export pixel art game effects from Claude Code or Codex
Not checked yet- Remote
- Freemium
- Design and media