Wavespeed MCP server
{
"mcpServers": {
"wavespeed": {
"command": "npx",
"args": [
"-y",
"@wavespeed/mcp@latest"
],
"env": {
"WAVESPEED_API_KEY": "<wavespeed_api_key>"
}
}
}
}{
"mcpServers": {
"wavespeed": {
"command": "npx",
"args": [
"-y",
"@wavespeed/mcp@latest"
],
"env": {
"WAVESPEED_API_KEY": "<wavespeed_api_key>"
}
}
}
}{
"mcpServers": {
"wavespeed": {
"command": "npx",
"args": [
"-y",
"@wavespeed/mcp@latest"
],
"env": {
"WAVESPEED_API_KEY": "<wavespeed_api_key>"
}
}
}
}{
"servers": {
"wavespeed": {
"command": "npx",
"args": [
"-y",
"@wavespeed/mcp@latest"
],
"env": {
"WAVESPEED_API_KEY": "${input:wavespeed_api_key}"
}
}
},
"inputs": [
{
"id": "wavespeed_api_key",
"type": "promptString",
"description": "Wavespeed api key",
"password": true
}
]
}{
"mcpServers": {
"wavespeed": {
"command": "npx",
"args": [
"-y",
"@wavespeed/mcp@latest"
],
"env": {
"WAVESPEED_API_KEY": "<wavespeed_api_key>"
}
}
}
}file .mcp.json (in your project root)file claude_desktop_config.jsonfile ~/.cursor/mcp.jsonfile .vscode/mcp.jsonfile ~/.codeium/windsurf/mcp_config.jsoninstall npx -y @wavespeed/mcpversion 1.0.7
What it does
An MCP server for the WaveSpeed platform that exposes a live catalog of image, video, audio, and 3D models. Developers use it to run generative models from Claude, Cursor, or any MCP client without maintaining a hardcoded model list.
- Generate images or videos from text prompts by querying the live model catalog and running the selected model.
- Transform local files (images, audio) by uploading them and passing them to models that accept file inputs.
- Check pricing and account balance before submitting model runs to control costs.
Tools this server exposes
| Tool | Does |
|---|---|
| list_models | Search the live catalog by text query or modality type (image, video, audio, 3D). |
| get_model_schema | Retrieve the input schema for a model, including required fields, properties, and defaults. |
| run_model | Execute a model with specified inputs; files marked with @path are automatically uploaded and substituted with hosted URLs. |
| get_price | Get a cost estimate for a model run, disclosing which inputs were unpriced. |
| get_balance | Check the current account credit balance. |
| upload_file | Upload a local file and receive a hosted URL; identical files are deduplicated by content hash for 24 hours. |
| get_prediction | Retrieve the status and outputs of a previous model run by its prediction id. |
Before you enable it
An MCP server runs with whatever access you give it. Start with a development account rather than production, and check which tools the server exposes before you let an agent call them unattended.