# Wavespeed MCP MCP server

Run any model on the live WaveSpeed catalog: image, video, audio, 3D.

## At a glance

Wavespeed MCP is an MCP server in the Design & Media category. It runs locally over stdio via `npx -y @wavespeed/mcp`, and needs WAVESPEED_API_KEY. It exposes 16 tools, including list_models, get_model_schema and run_model. It scores A (89/100) on the MCP Skills Hub health score as of Oct 28, 2026.

## Install

### How to install Wavespeed MCP in Claude Code

1. Add the server

```bash
claude mcp add wavespeed -e 'WAVESPEED_API_KEY=<WAVESPEED_API_KEY>' -- npx -y @wavespeed/mcp
```

2. Fill in your credentials

   Replace <WAVESPEED_API_KEY> with your real value. Keep secrets out of any config file you commit.

3. Verify it's connected

```bash
claude mcp list
```

4. Sharing it with your team?

   Add `--scope project` to write it to .mcp.json in the repository root, which you can commit (with the secrets left as environment variables).

5. Use it in a session

   Ask Claude to use the tools this server exposes (e.g. list_models, get_model_schema, run_model). It discovers them automatically.

### How to install Wavespeed MCP in Claude Desktop

1. Open your MCP config

   macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Add this server

```json
{
  "mcpServers": {
    "wavespeed": {
      "command": "npx",
      "args": [
        "-y",
        "@wavespeed/mcp"
      ],
      "env": {
        "WAVESPEED_API_KEY": "<WAVESPEED_API_KEY>"
      }
    }
  }
}
```

3. Fill in your credentials

   Replace <WAVESPEED_API_KEY> with your real value. Keep secrets out of any config file you commit.

4. Restart Claude Desktop

   The tools appear under the 🔌 menu once the app reloads.

### How to install Wavespeed MCP in Cursor

1. Create / edit .cursor/mcp.json in your project

```json
{
  "mcpServers": {
    "wavespeed": {
      "command": "npx",
      "args": [
        "-y",
        "@wavespeed/mcp"
      ],
      "env": {
        "WAVESPEED_API_KEY": "<WAVESPEED_API_KEY>"
      }
    }
  }
}
```

2. Fill in your credentials

   Replace <WAVESPEED_API_KEY> with your real value. Keep secrets out of any config file you commit.

3. Enable it

   Cursor Settings → MCP → toggle the server on. Tools become available to the Composer/Agent.

### How to install Wavespeed MCP in Codex CLI

1. Add to ~/.codex/config.toml

```toml
[mcp_servers.wavespeed]
command = "npx"
args = ["-y", "@wavespeed/mcp"]
env = { WAVESPEED_API_KEY = "<WAVESPEED_API_KEY>" }
```

2. Fill in your credentials

   Replace <WAVESPEED_API_KEY> with your real value. Keep secrets out of any config file you commit.

3. Run Codex

   Codex loads MCP servers from config.toml on startup and exposes their tools to the agent.

### How to install Wavespeed MCP in Windsurf

1. Edit ~/.codeium/windsurf/mcp_config.json

```json
{
  "mcpServers": {
    "wavespeed": {
      "command": "npx",
      "args": [
        "-y",
        "@wavespeed/mcp"
      ],
      "env": {
        "WAVESPEED_API_KEY": "<WAVESPEED_API_KEY>"
      }
    }
  }
}
```

2. Fill in your credentials

   Replace <WAVESPEED_API_KEY> with your real value. Keep secrets out of any config file you commit.

3. Reload

   Windsurf → Cascade → refresh MCP servers. Cascade can now call the tools.

### How to install Wavespeed MCP in Cline

1. Open Cline → MCP Servers → Configure

   Adds to cline_mcp_settings.json.

2. Add the server

```json
{
  "mcpServers": {
    "wavespeed": {
      "command": "npx",
      "args": [
        "-y",
        "@wavespeed/mcp"
      ],
      "env": {
        "WAVESPEED_API_KEY": "<WAVESPEED_API_KEY>"
      }
    }
  }
}
```

3. Fill in your credentials

   Replace <WAVESPEED_API_KEY> with your real value. Keep secrets out of any config file you commit.

### How to install Wavespeed MCP in VS Code

1. Create .vscode/mcp.json

```json
{
  "servers": {
    "wavespeed": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@wavespeed/mcp"
      ],
      "env": {
        "WAVESPEED_API_KEY": "<WAVESPEED_API_KEY>"
      }
    }
  }
}
```

2. Fill in your credentials

   Replace <WAVESPEED_API_KEY> with your real value. Keep secrets out of any config file you commit.

3. Start it

   VS Code shows a ▶ Start action above the server entry. Agent mode (Copilot Chat) can then use the tools.

## Tools

- `list_models` — Search the live catalog by text or modality type
- `get_model_schema` — A model's real input schema (required, properties, defaults), with a link to the model's playground page
- `run_model` — Submit + wait; rejects input keys the model doesn't accept; `@path` inputs upload automatically; returns output URLs
- `generate_image` — Image from a prompt with the /chat image models (default Seedream 5 Pro); reference images use the model's edit endpoint
- `edit_image` — Edit, restyle or combine existing images with the same models
- `generate_video` — Video from a prompt, a first/last frame or reference images/videos/audio, with the /chat video models (default Seedance 2.5); the mode (text, image, reference) is picked from the inputs
- `edit_video` — Edit an existing video, optionally with reference images/audio
- `extend_video` — Continue an existing video with new footage
- `get_price` — Cost estimate for the inputs you pass (no charge), with a link to the model's playground page
- `get_balance` — Account credit balance, with the top-up link
- `list_predictions` — Run history (default last 24h); filter by model, status, time range
- `list_billings` — Itemized charges and refunds (needs a Billing-access key)
- `get_usage` — Spend, request counts and per-model breakdown (default last 7 days; needs a Billing-access key)
- `delete_predictions` — Delete finished runs from the history (up to 100; needs `confirm: true`, cannot be undone from here)
- `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

Source repository: https://github.com/WaveSpeedAI/mcp-server

---

Source: https://mcp-skills-hub.vercel.app/mcps/ai-wavespeed-mcp · MCP Skills Hub · data as of 2026-10-28T12:31:05Z