Wan30 MCP

Wan30 MCP and CLI — Wan 3.0 AI Video Generation

Generate Wan 3.0 videos from your terminal or AI assistant with your wan30.video account. MCP and CLI spend the same credit balance as the website, at the same prices. Credits are bought on the website.

Access requires remaining purchased credits. Sign-up, check-in and gift credits alone do not qualify. Buy credits at https://wan30.video/pricing/.

Node 22+, macOS or Linux (including WSL).

Install

npm install -g @wan30/cli

Use

wan30 auth login
wan30 account
wan30 models
wan30 estimate --input request.json
wan30 create --input request.json --wait
wan30 download <taskId> --output result.mp4
wan30 auth logout

On Linux, sign in with wan30 auth login --credential-store file.

request.json examples. Text to video:

{"modelId":"wan30-text-to-video","prompt":"A paper boat on a rainy street","durationSeconds":5,"resolution":"720p"}

Image to video, with one HTTPS image as the first frame:

{"modelId":"wan30-image-to-video","prompt":"The crane takes off","imageUrls":["https://example.org/first-frame.jpg"]}

Reference to video, with 1–10 HTTPS reference images:

{"modelId":"wan30-reference-to-video","prompt":"Move the camera slowly toward the scene","imageUrls":["https://example.org/reference.jpg"]}

Every mode takes 2–30 seconds and 480p, 720p or 1080p. The default is 5 seconds at 480p. wan30 model <modelId> prints every option as a JSON Schema.

create prints a request ID on stderr. Re-running it with --request-id <id> after a network error returns the same task and is never charged twice. A wait timeout only stops waiting; the task keeps running.

Credentials are stored in the macOS Keychain, or with --credential-store file in a private file (directory 0700, file 0600). WAN30_CONFIG_DIR changes that directory. WAN30_ACCESS_TOKEN accepts a pre-issued access token for automation. Logging out revokes this connection; changing your website password revokes every connection.

Connect an assistant (local MCP)

Sign in once with wan30 auth login, then register the stdio server:

codex mcp add wan30 -- wan30 mcp
claude mcp add wan30 -- wan30 mcp

Tools: account_status, list_models, get_model, estimate_generation, generate_video, list_tasks, get_task.

Clients that accept JSON configuration can launch the same stdio server with npx:

{
  "mcpServers": {
    "wan30": {
      "command": "npx",
      "args": ["-y", "@wan30/cli", "mcp"]
    }
  }
}

The server starts and lists its tools before you sign in. A tool call made without a sign-in tells the assistant to run wan30 auth login; no restart is needed afterwards.

Read the account status and estimate the cost before generating. Video generation spends your website credits.

Documentation and support

• Wan30 website
• MCP setup and client instructions
• CLI installation
• MCP and CLI usage guide
• Credit packs
• Issue tracker

License

MIT. The hosted generation service is operated at wan30.video.