
MCP server
Run any model on the live WaveSpeed catalog: image, video, audio, 3D.
32 stars193 downloads/wk
Reviews
Write oneNobody has reviewed MCP yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
MCP tools (7, 2 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
get_balanceShow the WaveSpeed account credit balance.
get_model_schemaGet a model's real input schema (required fields, properties, defaults). Call this before run_model so inputs match what the model actually accepts.
get_predictionFetch the status and outputs of a past or in-flight prediction by id — use to recover a run that hit the wait limit.
get_priceEstimate the cost of a run before executing it (no charge). Provide the same input you would pass to run_model — pricing often depends on inputs like duration or resolution.
list_modelsSearch the live WaveSpeed model catalog (image, video, audio, 3D). Returns model IDs usable with run_model. Do not invent model IDs — always pick one returned by this tool.
run_modelwrite actionRun any WaveSpeed model. input keys come from get_model_schema. Local files: pass "@./path" string values — they are uploaded and replaced with hosted URLs (bare paths are NOT uploaded). Returns output URLs. If the wait limit is hit, the task keeps running; recover it with get_prediction.
upload_filewrite actionUpload a local file to WaveSpeed and get its hosted URL (identical bytes reuse the same upload for 24h). Usually unnecessary — run_model handles "@./path" inputs itself.
Public scan report
scanner v0.1.9 · 2026-09-21 · same rubric, same numbers if you re-run it
- Code scan8 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 1 days ago15/15
- Maintainer identitynamespace and repository owner differ; GitHub account older than a year; website matches verified namespace8/10
What the publisher says
From the MCP repository's README, as published. We do not edit it. Read it on GitHub
WaveSpeed MCP Server
<!-- mcp-name: ai.wavespeed/mcp -->
An MCP server for the WaveSpeed platform: run any model on the live catalog — image, video, audio, 3D — from Claude Code, Claude Desktop, Cursor, Cline, or any MCP client.
Built on the same design as the open-source @wavespeed/cli:
- No hardcoded models. The catalog comes from the live API (1h cache); new platform models work the day they ship.
- One generation verb. runmodel executes anything; getmodel_schema tells the agent what inputs a model actually accepts, so it reads before it writes.
- Inputs are never mutated. The one explicit transform is the @path marker — a "@./photo.jpg" value inside input uploads the file and substitutes its hosted URL. Bare paths are passed through untouched.
- Honest pricing. getprice quotes before you spend and names the inputs the quote was blind to (unpricedinputs) instead of presenting a formula's floor as "the" price.
Tools
If runmodel hits its wait limit the task keeps running server-side — the error names the prediction id, and getprediction picks it up.
Setup
Auth resolves from WAVESPEEDAPIKEY, or from the CLI's stored login (wavespeed login) — one login covers both tools. Keys: wavespeed.ai/accesskey.
Claude Code
claude mcp add wavespeed -- npx -y @wavespeed/mcpClaude Desktop / other clients (mcpServers config):
{
"mcpServers": {
"wavespeed": {
"command": "npx",
"args": ["-y", "@wavespeed/mcp"],
"env": { "WAVESPEED_API_KEY": "wsk_..." }
}
}
}Example prompts
- "Generate a 16:9 hero image of a cyberpunk skyline at golden hour."
- "Take ./photo.jpg and replace the background with a sunlit kitchen." (the agent passes "@./photo.jpg")
- "Animate ./hero.png with subtle parallax — check the price first."
Development
npm install
npm run dev # run from source (stdio)
npm run lint # typecheck
npm run build # tsc → dist/License
MIT
WaveSpeed AI — AI image & video generation platform. Try it in the browser: Image generator · Video generator
Nothing above is checked by us. What we check is on the safety report.
Install directly
Runs npx -y @wavespeed/mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add mcp -- npx -y @wavespeed/mcp
MCP: common questions
- Is MCP server safe?
- Mostly: it is graded B (83/100). Read the MCP safety report
- How do I install MCP?
- It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.
- Does MCP need an API key?
- Yes. The registry entry asks for
WAVESPEED_API_KEY. - Is MCP maintained?
- The last commit was in the last day (2026-09-20). The latest release is v1.0.7.
- What can I use instead of MCP?
- Servers from other publishers that do the same job: Runapi MCP server, Agent-Native Assets MCP server and Watch Skill MCP server. Compare all MCP alternatives.
Alternatives to MCP
Same job from other publishers: the closest match first, then the best rated.
- Runapi130+ AI models for image, video, music, and audio — 18 model families, one RunAPI account.not reviewedEstablishedA
- Agent-Native AssetsDigital asset manager - upload, organize, search, and generate on-brand images and videosnot reviewedEstablishedA
- Watch SkillWatch video and live sessions, keep timestamped evidence, and verify an agent's own work.not reviewedGrowingB
- MaginaryAI image + video generation for agents: --flag prompt DSL, async generate/poll, x402 pay-per-use.not reviewedGrowingB
- Claude Real VideoLet any LLM watch a video locally — and search everything it has ever watched.not reviewedEstablishedA