WaveSpeed MCP Server
OfficialThis server provides AI media generation and management tools via the WaveSpeed API, including text-to-image, image-to-image, and video generation, along with utilities for model discovery, pricing, file uploads, and prediction tracking.
Generate images from text prompts (
text_to_image): Create images with customizable size, steps, guidance, LoRA models, safety checker, and seed.Transform existing images (
image_to_image): Modify or stylize one or more input images using text prompts and optional model settings.Generate videos (
generate_video): Animate an input image with text prompts, including duration (5 or 10s), negative prompts, motion intensity (flow_shift), and other parameters.List and search models (
list_models): Discover available models from the live catalog by text or modality.Get model schemas (
get_model_schema): Retrieve the exact input schema for any model to know required parameters.Check pricing (
get_price): Estimate costs before running a generation, with transparency about unpriced inputs.Check account balance (
get_balance): View available credits.Upload files (
upload_file): Host local files as URLs for use in generation inputs.Retrieve prediction results (
get_prediction): Fetch status or output of previously submitted jobs by ID.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@WaveSpeed MCP Servergenerate an image of a serene mountain lake at sunrise"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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_modelexecutes anything;get_model_schematells the agent what inputs a model actually accepts, so it reads before it writes.Inputs are never mutated. The one explicit transform is the
@pathmarker — a"@./photo.jpg"value insideinputuploads the file and substitutes its hosted URL. Bare paths are passed through untouched.Honest pricing.
get_pricequotes 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 |
| Search the live catalog by text or modality type |
| A model's real input schema (required, properties, defaults) |
| Submit + wait; |
| Cost estimate with |
| Account credit balance |
| Local file → hosted URL (24h content-hash dedupe) |
| 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/mcpClaude 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
Maintenance
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceExposes litmedia.ai text-to-image and image-to-video generation tools via MCP, enabling AI agents to generate images and videos directly from prompts.1MIT
- FlicenseAqualityDmaintenanceAn MCP server that provides a standardized interface for accessing WaveSpeed AI's image and video generation capabilities, including text-to-image, image-to-image, inpainting, and dynamic video generation.3
- FlicenseNot gradedqualityDmaintenanceProvides a audio/video creation toolbox via MCP protocol, enabling natural language-based video editing tasks such as image-to-video, video merging, subtitle extraction, and more.3
- FlicenseNot gradedqualityDmaintenanceProvides MCP interfaces for AI text-to-image, image-to-video, and text-to-video generation using the Doubao API.1
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.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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