How do I install WaveSpeed?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does WaveSpeed need an API key?

The publisher lists these environment variables: WAVESPEED_API_KEY, WAVESPEED_BASE_URL, WAVESPEED_CLIENT_NAME.

What transport does WaveSpeed use?

WaveSpeed is reached over HTTP.

When was WaveSpeed last checked?

Last checked 2026-11-10. Run any model on the live WaveSpeed catalog: image, video, audio, 3D.

WaveSpeed MCP server

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

https://api.wavespeed.ai/mcp

Credentials from the publisher

WAVESPEED_API_KEY — WaveSpeed API key (https://wavespeed.ai/accesskey). Optional when the wavespeed CLI is logged in.
WAVESPEED_BASE_URL — Override the WaveSpeed API base URL. Defaults to https://api.wavespeed.ai.
WAVESPEED_CLIENT_NAME — Override the client name reported for channel attribution. Defaults to wavespeed-mcp.

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

1claude mcp add --transport http ai.wavespeed-mcp https://api.wavespeed.ai/mcp

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "ai.wavespeed-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://api.wavespeed.ai/mcp"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Remote

Transport: http
Version

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

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_model executes anything; get_model_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. get_price quotes 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

MIT

WaveSpeed AI — AI image & video generation platform. Try it in the browser: Image generator · Video generator

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install WaveSpeed?

Does WaveSpeed need an API key?

What transport does WaveSpeed use?

When was WaveSpeed last checked?

Documentation

WaveSpeed MCP Server

Tools

Setup

Example prompts

Development

License