# WaveSpeed MCP

> WaveSpeed's live image, video, audio and 3D catalogue behind seven tools, hosted or via npx.

- **Category:** Model Hubs
- **Vendor:** WaveSpeed AI (official)
- **Pricing:** credits
- **Verified:** 2026-10-19

## What it does

WaveSpeed's own server reads its model catalogue from the live API instead of a pinned list, so an agent searches with list_models, reads a model's real input schema with get_model_schema, quotes the job with get_price, then fires run_model. For a filmmaker-agent that is one bill and one verb across many upstream image and video models, with an explicit price check before an expensive shot and resumable polling for renders that outlast a single tool call.

## Connect

- Remote endpoint: `https://api.wavespeed.ai/mcp`
- Claude Code: `claude mcp add --transport http wavespeed https://api.wavespeed.ai/mcp`
- Local: `npx -y @wavespeed/mcp`

**Auth:** oauth (env `WAVESPEED_API_KEY`) — <https://wavespeed.ai/accesskey> — the hosted server signs in through the browser and mints a key named 'MCP · <app>'; the npx server and header-only clients take WAVESPEED_API_KEY or an Authorization: Bearer header

## Capabilities

[multi-model-generation](https://mcp.film/capabilities/multi-model-generation.md) · [text-to-image](https://mcp.film/capabilities/text-to-image.md) · [text-to-video](https://mcp.film/capabilities/text-to-video.md) · [image-to-video](https://mcp.film/capabilities/image-to-video.md) · [audio-generation](https://mcp.film/capabilities/audio-generation.md) · [3d-generation](https://mcp.film/capabilities/3d-generation.md) · [model-discovery](https://mcp.film/capabilities/model-discovery.md) · [cost-tracking](https://mcp.film/capabilities/cost-tracking.md)

## Sample tools

`list_models` · `get_model_schema` · `run_model` · `get_price` · `get_balance` · `upload_file` · `get_prediction`

## Field notes

Verified 19 Oct 2026 from the repo, npm and wavespeed.ai/docs/mcp. MIT, 34 stars, repo pushed and npm @wavespeed/mcp 1.0.11 published that same day; the package has existed only since 19 Aug 2026, so it is young and moving fast. api.wavespeed.ai/mcp answers 405 to a plain GET, as a streamable-HTTP endpoint should. The good: get_price discloses which inputs its quote ignored (unpriced_inputs) instead of passing off a floor as the price, and run_model rejects input keys the model does not accept before you are charged. The caveats: the vendor says the quote is an estimate and the amount actually charged is what counts; the hosted server cannot read local files, so pass public URLs or use its create_upload flow, while @path uploads work only in the npx version; and on the hosted server run_model waits at most 100 seconds (1,800 locally) before handing back a prediction id to poll with get_prediction. Deleting the 'MCP · <app>' key disconnects a client. A separate community Python package called WavespeedMCP exists; this entry is the vendor's own. The lane is crowded — compare fal, replicate, runware and atlas-cloud on catalogue and price.

## Alternatives

- [Atlas Cloud MCP](https://mcp.film/mcps/atlas-cloud.md) — One API key over a large image, video, audio and 3D model catalogue, with a dry-run flag.
- [Runware MCP](https://mcp.film/mcps/runware.md) — Official Runware MCP for image, video, audio, 3D, upscaling, and model search.
- [inference.sh MCP Server](https://mcp.film/mcps/inference-sh.md) — Official hosted hub: run any image, video, audio or 3D app, then poll the task.
- [Popcraft MCP](https://mcp.film/mcps/popcraft.md) — Hosted OAuth MCP for 20+ video, image, audio and 3D models, with a credit preview on every call.
- [ComfyUI MCP](https://mcp.film/mcps/comfyui.md) — Drive a local ComfyUI: 40+ tools for image, video, audio and 3D workflows.
- [PiAPI MCP Server](https://mcp.film/mcps/piapi.md) — Midjourney in an agent — plus Kling, Luma, Hailuo, Hunyuan, Wan, Suno via PiAPI.

## Verification

- Status: Freshly checked (checked today)
- Added: 2026-10-19
- Last verified: 2026-10-19
- Machine JSON: https://mcp.film/api/mcps/wavespeed.json

## Links

- Site: https://wavespeed.ai/?utm_source=mcp.film&utm_medium=referral&utm_campaign=directory&utm_content=wavespeed%3Asite
- Docs: https://wavespeed.ai/docs/mcp?utm_source=mcp.film&utm_medium=referral&utm_campaign=directory&utm_content=wavespeed%3Adocs
- Repo: https://github.com/WaveSpeedAI/mcp-server

---

Structured data: https://mcp.film/api/mcps/wavespeed.json · Directory: https://mcp.film
Canonical: https://mcp.film/mcps/wavespeed/
Hosted directory MCP: https://mcp.film/mcp