About WaveSpeed
WaveSpeed is an MCP server published by WaveSpeedAI in the Developer Tools category: waveSpeed MCP server — run any model on the live catalog (image, video, audio, 3D) with schema introspection, @path file upload, and price quotes.
The repository has 34 stars and 9 forks, with the last commit 4 days ago. Recent commit activity is the strongest signal that reported issues will get attention.
Install
git clone https://github.com/WaveSpeedAI/mcp-serverThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (7)
get_balanceAccount credit balance
Parameters not published.
get_model_schemaA model's real input schema (required, properties, defaults)
Parameters not published.
get_predictionRecover status/outputs of any run by id
Parameters not published.
get_priceCost estimate with `unpriced_inputs` / `at_base_price` disclosure
Parameters not published.
list_modelsSearch the live catalog by text or modality type
Parameters not published.
run_modelSubmit + wait; `@path` inputs upload automatically; returns output URLs
Parameters not published.
upload_fileLocal file → hosted URL (24h content-hash dedupe)
Parameters not published.
Ask AI
Ask AI about WaveSpeed
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 7 days ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- ✓License declaredUsable under a stated license.
- ✓Tests presentA test suite exists in the repository.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
README
WaveSpeed MCP Server
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.
run_modelexecutes anything;get_model_schematells the agent what inputs a model actually accepts, so it reads before it writes. - Inputs are never mutated. The one explicit transform is the
@pathmarker — a"@./photo.jpg"value insideinputuploads the file and substitutes its hosted URL. Bare paths are passed through untouched. - Honest pricing.
get_pricequotes before you spend and names the inputs the quote was blind to (unpriced_inputs) instead of presenting a formula's floor as "the" price.
Tools
| Tool | What it does |
|---|---|
list_models |
Search the live catalog by text or modality type |
get_model_schema |
A model's real input schema (required, properties, defaults) |
run_model |
Submit + wait; rejects input keys the model doesn't accept; @path inputs upload automatically; returns output URLs |
get_price |
Cost estimate with unpriced_inputs / at_base_price disclosure |
get_balance |
Account credit balance |
upload_file |
Local file → hosted URL (24h content-hash dedupe) |
get_prediction |
Status/outputs of any run by id; optional wait_seconds to wait for it |
Some generations take minutes to hours. run_model waits up to wait_seconds (default 50, max 1800) and then returns done: false with the prediction id — the task keeps running server-side, and get_prediction picks it up. While waiting, both tools send MCP progress notifications that carry the prediction id.
Setup
Auth resolves from WAVESPEED_API_KEY, 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/mcp
Claude 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
WaveSpeed AI — AI image & video generation platform. Try it in the browser: Image generator · Video generator
README fetched from the repository 7 days ago. The original is authoritative.