Skip to main content
Glama
WaveSpeedAI

WaveSpeed MCP Server

Official

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; @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

Recover status/outputs of any run by id

If run_model hits its wait limit the task keeps running server-side — the error names the prediction id, and get_prediction picks it up.

Related MCP server: WavespeedMCP

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

Install Server
A
license - permissive license
A
quality
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • Generate images with any major model — one API key, one prepaid balance, one MCP.

  • MCP server for Wan AI video generation

  • OCR, transcription, file extraction, and image generation for AI agents via MCP.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/WaveSpeedAI/mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server