\n\n# WaveSpeed MCP Server\n\n\n \n \n \n \n\n\n\n\nAn MCP server for the [WaveSpeed](https://wavespeed.ai) platform: run any model on the **live catalog** — image, video, audio, 3D — from Claude Code, Claude Desktop, Cursor, Cline, or any MCP client.\n\nBuilt on the same design as the open-source [`@wavespeed/cli`](https://github.com/WaveSpeedAI/wavespeed-cli):\n\n- **No hardcoded models.** The catalog comes from the live API (1h cache); new platform models work the day they ship.\n- **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.\n- **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.\n- **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.\n\n## Tools\n\n| Tool | What it does |\n|---|---|\n| `list_models` | Search the live catalog by text or modality type |\n| `get_model_schema` | A model's real input schema (required, properties, defaults) |\n| `run_model` | Submit + wait; `@path` inputs upload automatically; returns output URLs |\n| `get_price` | Cost estimate with `unpriced_inputs` / `at_base_price` disclosure |\n| `get_balance` | Account credit balance |\n| `upload_file` | Local file → hosted URL (24h content-hash dedupe) |\n| `get_prediction` | Recover status/outputs of any run by id |\n\nIf `run_model` hits its wait limit the task keeps running server-side — the error names the prediction id, and `get_prediction` picks it up.\n\n## Setup\n\nAuth resolves from `WAVESPEED_API_KEY`, or from the CLI's stored login (`wavespeed login`) — one login covers both tools. Keys: [wavespeed.ai/accesskey](https://wavespeed.ai/accesskey).\n\n**Claude Code**\n\n```bash\nclaude mcp add wavespeed -- npx -y @wavespeed/mcp\n```\n\n**Claude Desktop / other clients** (`mcpServers` config):\n\n```json\n{\n \"mcpServers\": {\n \"wavespeed\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@wavespeed/mcp\"],\n \"env\": { \"WAVESPEED_API_KEY\": \"wsk_...\" }\n }\n }\n}\n```\n\n## Example prompts\n\n- *\"Generate a 16:9 hero image of a cyberpunk skyline at golden hour.\"*\n- *\"Take ./photo.jpg and replace the background with a sunlit kitchen.\"* (the agent passes `\"@./photo.jpg\"`)\n- *\"Animate ./hero.png with subtle parallax — check the price first.\"*\n\n## Development\n\n```bash\nnpm install\nnpm run dev # run from source (stdio)\nnpm run lint # typecheck\nnpm run build # tsc → dist/\n```\n\n## License\n\n[MIT](LICENSE)\n\n---\n\n**[WaveSpeed AI](https://wavespeed.ai/)** — AI image & video generation platform.\nTry it in the browser: **[Image generator](https://wavespeed.ai/image-generator)** · **[Video generator](https://wavespeed.ai/video-generator)**\n",
"bytes": 3672,
"sha": "04426ecbaadcf306ae3309e912dee7df6590aa4d6bd855314d038ffc657a3a00",
"repo_slug": "wavespeedai/mcp-server",
"fonte": "repo",
"truncated": false,
"api": "https://agentalog.com/api/listings/mcp_ai_wavespeed_mcp_a41c2148/readme"
}
![\"WaveSpeed\"](\"assets/wavespeed-logo-dark.svg\"){kind=logo}
\n ![\"Add](\"https://cursor.com/deeplink/mcp-install-light.svg\")
\n