WavespeedMCP

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.

Local serverstdioMIT

What is the WavespeedMCP MCP Server?

WavespeedMCP is an MCP project maintained in the wavespeedai/mcp-server repository. The maintainer describes its purpose as “An MCP server for the WaveSpeed platform: run any model on the live catalog — image, video, audio, 3D — from Claude Code, Claude Desktop…”. Read the project documentation for the complete scope.

Installation

The documented npm package is @wavespeed/mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares WAVESPEED_API_KEY. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
list_modelsSearch the live catalog by text or modality type
get_model_schemaA model's real input schema (required, properties, defaults)
run_modelSubmit + wait; rejects input keys the model doesn't accept; @path inputs upload automatically; returns output URLs
get_priceCost estimate with unpriced_inputs / at_base_price disclosure
get_balanceAccount credit balance
upload_fileLocal file → hosted URL (24h content-hash dedupe)
get_predictionStatus/outputs of any run by id; optional wait_seconds to wait for it

How to install the WavespeedMCP MCP Server

{
  "mcpServers": {
    "wavespeed": {
      "command": "npx",
      "args": [
        "-y",
        "@wavespeed/mcp"
      ],
      "env": {
        "WAVESPEED_API_KEY": "YOUR_WAVESPEED_API_KEY"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
WAVESPEED_API_KEYDeclared in the maintainer’s client configuration.Check documentation