# WaveSpeedAI MCP Server (MCP server)

> WaveSpeedAI MCP Server is an MCP server that adds search and knowledge tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Run any model on the live WaveSpeed catalog: image, video, audio, 3D. It has 33 GitHub stars, is released under the MIT license and runs locally with npx -y @wavespeed/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.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/WaveSpeedAI/mcp-server |
| GitHub stars | 33 |
| License | MIT |
| Language | TypeScript |
| Transport | stdio |
| Packages | npm: @wavespeed/mcp |
| Remote URL | none |
| Needs API key | no |
| Official | yes |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | AI & search |
| Latest release | none |
| Last commit | Oct 1, 2026 |
| MCP registry name | ai.wavespeed/mcp |

## Install

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "wavespeedai-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@wavespeed/mcp"
      ],
      "env": {
        "WAVESPEED_API_KEY": "your-value"
      }
    }
  }
}
```

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --env WAVESPEED_API_KEY=your-value --transport stdio wavespeedai-mcp-server -- npx -y @wavespeed/mcp
```

### Cursor (.cursor/mcp.json)

```json
{
  "mcpServers": {
    "wavespeedai-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@wavespeed/mcp"
      ],
      "env": {
        "WAVESPEED_API_KEY": "your-value"
      }
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

### VS Code (.vscode/mcp.json)

```json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "wavespeed_api_key",
      "description": "WAVESPEED_API_KEY",
      "password": true
    }
  ],
  "servers": {
    "wavespeedai-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@wavespeed/mcp"
      ],
      "env": {
        "WAVESPEED_API_KEY": "${input:wavespeed_api_key}"
      }
    }
  }
}
```

Config formats checked against the official docs on 2026-10-07.

## Environment variables

- `WAVESPEED_API_KEY` (secret): WaveSpeed API key (https://wavespeed.ai/accesskey). Optional when the wavespeed CLI is logged in.
- `WAVESPEED_BASE_URL`: Override the WaveSpeed API base URL. Defaults to https://api.wavespeed.ai.
- `WAVESPEED_CLIENT_NAME`: Override the client name reported for channel attribution. Defaults to wavespeed-mcp.

## Tools

- `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; rejects input keys the model doesn't accept; @path inputs upload automatically; returns output URLs
- `get_price`: Cost estimate with unpricedinputs / atbaseprice disclosure
- `get_balance`: Account credit balance
- `upload_file`: Local file → hosted URL (24h content-hash dedupe)
- `get_prediction`: Status/outputs of any run by id; optional waitseconds to wait for it

## Similar MCP servers

- [Context7](https://appsgit.com/mcp-servers/context7): Up-to-date code docs for any prompt. (62,752 stars, MIT, needs API key)
- [FunASR](https://appsgit.com/mcp-servers/funasr): Transcribe local audio with FunASR and SenseVoice using private, on-device inference. (20,596 stars, MIT)
- [Bifrost](https://appsgit.com/mcp-servers/bifrost): Fastest enterprise AI gateway (50x faster than LiteLLM) with adaptive load balancer, cluster mode, guardrails, 1000+ models support & <100 µs overhead at 5k RPS. (8,591 stars, Apache-2.0)
- [Honcho](https://appsgit.com/mcp-servers/honcho): Memory that reasons: continual learning for stateful agents. (7,494 stars, AGPL-3.0, needs API key)
- [Semble](https://appsgit.com/mcp-servers/semble): Fast and Accurate Code Search for Agents. (6,185 stars, MIT)
- [Exa](https://appsgit.com/mcp-servers/exa): Connect AI agents to Exa for web search, content fetching, and multi-step research. (5,088 stars, MIT, official)

---

Canonical page: https://appsgit.com/mcp-servers/wavespeedai-mcp-server
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.