Wan30 MCP and CLI — Wan 3.0 AI Video Generation

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

Access requires remaining purchased credits. Sign-up, check-in and giftcredits 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 5seconds 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 nevercharged 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 apre-issued access token for automation. Logging out revokes this connection;changing your website password revokes every connection.

Connect an assistant (local MCP)

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 withnpx:

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

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

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

Documentation and support

License

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

Wan30 MCP and CLI — Wan 3.0 AI Video Generation