list_models
Search the live WaveSpeed model catalog (image, video, audio, 3D). Returns model IDs usable with run_model. Do not invent model IDs — always pick one returned by this tool.
typelimitqueryrefreshai.wavespeed由 wavespeed.ai 發布官方發布者v1.2.10更新於 Nov 6, 2026
Run any model on the live WaveSpeed catalog: image, video, audio, 3D.
WaveSpeed MCP 讓助理呼叫 WaveSpeed 即時目錄中的影像、影片、音訊與 3D 生成模型,並可預估價格、查看執行紀錄。
Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。
把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。
閱讀 https://sourceweft.com/mcp/ai.wavespeed%2Fmcp/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。把它新增到你客戶端的 mcpServers 設定中。 客戶端會在首次連接時完成 OAuth 登入。
{
"mcpServers": {
"wavespeed": {
"type": "http",
"url": "https://api.wavespeed.ai/mcp"
}
}
}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:
run_model. The catalog comes from the live API (1h cache); new platform models work the day they ship.run_model executes anything; get_model_schema tells the agent what inputs a model actually accepts, so it reads before it writes. generate_image, edit_image, generate_video, edit_video and extend_video skip that: they use the same models as the WaveSpeed /chat page, pick the endpoint for what you give them and fit the request to its live schema.@path marker — a "@./photo.jpg" value inside input uploads the file and substitutes its hosted URL. Bare paths are passed through untouched. The shortcut tools (generate_image etc.) are the exception: they pick the endpoint and fit the request to the model, and report what they changed in notes.get_price takes the same input as run_model and returns an estimate; the amount actually charged for a run is authoritative.The five shortcut tools take wait_seconds like run_model, and estimate_only: true returns the price and the exact request that would run without submitting or charging anything. In their prompts, media is named @image 1, @video 1, @audio 1 (in the order given); it is renamed to what each model expects. Models and defaults follow /chat: an unknown model is rejected, and a named model is never switched.
Some generations take minutes to hours. run_model submits the run and returns the prediction id right away (done: false); the assistant then calls get_prediction with that id and wait_seconds (max 1800) until done is true. The task keeps running server-side, so a dropped connection loses nothing. Pass wait_seconds to run_model to wait for a quick model in the same call. While waiting, both tools send MCP progress notifications that carry the prediction id.
The same server is hosted at:
Claude on the web / ChatGPT: add a custom connector with that address and approve the connection on the WaveSpeed page that opens. Approving creates a dedicated API key (named MCP · <app>) that you can delete on the API Keys page to disconnect.
Claude Code: claude mcp add --transport http wavespeed https://api.wavespeed.ai/mcp
VS Code: code --add-mcp '{"name":"wavespeed","type":"http","url":"https://api.wavespeed.ai/mcp"}'
Clients that only start local commands: connect through mcp-remote, which opens the same browser approval on first start:
Any other client that sends request headers: point it at the URL with Authorization: Bearer <your API key>.
The hosted server has the same tools, with one difference for files: it cannot read files on your computer, so pass public URLs, use create_upload from a tool that can send HTTP requests (it returns a temporary upload address and the download_url to use as an input), or, in ChatGPT, attach the file to the chat (the upload_attachment tool, which only ChatGPT can fill, imports it and returns a download_url). Full guide: wavespeed.ai/docs/mcp.
@latest makes npx fetch the newest release on each start; without it, npx runs a globally installed @wavespeed/mcp if one exists, however old.
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 Desktop / other clients (mcpServers config):
"@./photo.jpg")WaveSpeed AI — AI image & video generation platform. Try it in the browser: Image generator · Video generator
來源:README.md,提交 2510e29
Search the live WaveSpeed model catalog (image, video, audio, 3D). Returns model IDs usable with run_model. Do not invent model IDs — always pick one returned by this tool.
typelimitqueryrefreshGet a model's real input schema (required fields, properties, defaults). Call this before run_model so inputs match what the model actually accepts.
model必填Run any WaveSpeed model. input keys come from get_model_schema; unknown keys are rejected before submission. Local files: pass "@./path" in a media field (image, images, video, audio, mask …) — it is uploaded and replaced with hosted URLs (bare paths are NOT uploaded). Returns the prediction id right away (done=false); call get_prediction with that id and wait_seconds until done=true to get the output URLs. The task keeps running on the server. Pass wait_seconds here to wait for a quick model in the same call.
input必填model必填wait_secondsCreate an image from a text description with the same models as the WaveSpeed /chat page (seedream-5-pro, nano-banana-2.1, nano-banana-2, nano-banana-pro, gpt-image-2.6, gpt-image-2.5, gpt-image-2; default seedream-5-pro). Give reference_images to use existing images as subject, product, face or style (the model's edit endpoint is used). To change existing images use edit_image. In the prompt, name input media as @image 1, @image 2, @video 1, @audio 1 (counted in the order the lists are given); they are renamed to what the model expects.
modelprompt必填resolutionaspect_ratiowait_secondsestimate_onlyreference_imagesChange existing images with the same models as the WaveSpeed /chat page: edits, restyles, backgrounds, adding or removing things, combining several images. In the prompt, name input media as @image 1, @image 2, @video 1, @audio 1 (counted in the order the lists are given); they are renamed to what the model expects.
modelimages必填prompt必填resolutionaspect_ratiowait_secondsestimate_onlyCreate a video with the same models as the WaveSpeed /chat page (default seedance-2.5). Give first_frame to animate an image; give reference_images / reference_videos / reference_audios to keep characters, products, motion, voice or music. The right mode (text, image or reference to video) is picked from what you give. Videos can cost dollars: use estimate_only first when unsure. In the prompt, name input media as @image 1, @image 2, @video 1, @audio 1 (counted in the order the lists are given); they are renamed to what the model expects.
modelprompt必填durationlast_frameresolutionfirst_frameaspect_ratiowait_secondsestimate_onlyreference_audiosreference_imagesreference_videosEdit an existing video with the same models as the WaveSpeed /chat page. Name the video and any references in the prompt (e.g. "replace the cat in @video 1 with the lion from @image 1"). In the prompt, name input media as @image 1, @image 2, @video 1, @audio 1 (counted in the order the lists are given); they are renamed to what the model expects.
modelvideo必填prompt必填resolutionwait_secondsestimate_onlyreference_audiosreference_imagesContinue an existing video with new footage after its end, with the same models as the WaveSpeed /chat page. Turbo models cannot extend. In the prompt, name input media as @image 1, @image 2, @video 1, @audio 1 (counted in the order the lists are given); they are renamed to what the model expects.
modelvideo必填prompt必填durationlast_frameresolutionwait_secondsestimate_onlyEstimate the cost of a run before executing it (no charge). Provide the same input you would pass to run_model — pricing often depends on inputs like duration or resolution, and a quote made without them can be lower than the real charge.
inputmodel必填Show the WaveSpeed account credit balance, with the link to top up.
無需輸入參數。
List past predictions (run history), newest window first. Defaults to the last 24 hours; pass since/until (ISO or YYYY-MM-DD) for other ranges. Use get_prediction with an id for one task in full.
pagelimitmodelsinceuntilstatusList itemized charges and refunds (billing records). Requires an API key with Billing access.
keypagetypelimitmodelsinceuntilUsage statistics: spend, request counts, daily series and per-model breakdown. Defaults to the last 7 days. Requires an API key with Billing access.
modelsinceuntilDelete finished predictions from this account's run history, up to 100 at a time. This is a soft delete: each record stays, with status "deleted" and without its outputs, and list_predictions and get_prediction still return it that way; the output links are revoked (best effort). This tool cannot undo it. Runs that are still going are left alone, and only the key's own organization's records are deleted. Ask the user first, and pass confirm: true only after they agreed to delete these ids.
ids必填confirm必填Upload a local file to WaveSpeed and get its hosted URL (identical bytes reuse the same upload for 24h). Usually unnecessary — run_model handles "@./path" inputs itself.
path必填Fetch the status and outputs of a past or in-flight prediction by id — use to pick up a run that returned done=false. Pass wait_seconds to keep waiting for it to finish.
id必填wait_seconds已滿足適用檢查項的 100%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。
https://api.wavespeed.ai/mcp{ "mcpServers": { "wavespeed": { "command": "npx", "args": ["-y", "mcp-remote", "https://api.wavespeed.ai/mcp"] } }}claude mcp add wavespeed -- npx -y @wavespeed/mcp@latest{ "mcpServers": { "wavespeed": { "command": "npx", "args": ["-y", "@wavespeed/mcp@latest"], "env": { "WAVESPEED_API_KEY": "wsk_..." } } }}npm installnpm run dev # run from source (stdio)npm run lint # typechecknpm run build # tsc → dist/