# Wan27 MCP — AI Image and Video Generation

> Wan27 MCP — AI Image and Video Generation is a paid MCP server for design and media. Run Wan27 image and video jobs from the terminal or an agent, billed in site credits. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Paid
- **Starting price:** $9.9 a month
- **Platforms:** CLI, macOS, Linux
- **Website:** https://wan2-7.io/mcp/
- **Repository:** https://github.com/dieselniu/wan27-mcp
- **MCP Registry name:** io.github.DieselNiu/wan27-mcp
- **Categories:** design and media
- **Listing updated:** 2026-11-15

## About

The npm package @wan27/cli doubles as a local MCP server, and this repository is the public mirror of its 0.1.2 release, whose README describes that version as updating package discovery metadata and documentation over 0.1.1. Install it globally, run wan27 auth login to authorise in a browser, then register wan27 mcp with Codex, Claude Code or Cursor.

Beyond the MCP tools, the CLI has commands to list models, print a model's options as JSON Schema, estimate, create with an optional wait, upload a reference file and download results. Requests are small JSON files naming a model, prompt, duration or resolution, for example a five-second 720p text-to-video clip or a 2K image. A wait timeout only stops waiting and the task keeps running.

Access rules are the main thing to know. The README says an active paid subscription is required and that free accounts, unpaid trials and credit packs alone do not qualify; the website FAQ also mentions admin-granted Pro and unexpired purchased credits. Tasks already created keep running if access lapses. The site's plans show a free tier with watermarked images and preview-only video, Lite at $118.8 billed yearly and Pro at $300 billed yearly. A Docker container is provided for directory introspection.

## Features

- **Local MCP server:** Starts with wan27 mcp after a one-time browser sign-in.
- **Model schemas:** Prints every option of a model as JSON Schema.
- **Credit estimates:** Estimates a request's cost before it is created.
- **Reference uploads:** Uploads a PNG, JPEG or WebP under 5 MiB for image-to-video or edits.
- **Credential storage:** Keeps tokens in the macOS Keychain or a private file.
- **Automation token:** WAN27_ACCESS_TOKEN accepts a pre-issued token for scripts.

## Good for

- Create a short text-to-video clip from a prompt
- Turn a still frame into a moving clip
- Generate 2K images from a terminal script
- Check model options and cost before spending credits
- Download finished task outputs from a script

## Install

### Claude Code (Terminal)

```sh
claude mcp add wan27-mcp -- npx -y @wan27/cli
```

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

```json
{
  "servers": {
    "wan27-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@wan27/cli"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `account_status`: Shows account status and credits.
- `list_models`: Lists available models.
- `get_model`: Shows a model's options and schema.
- `estimate_generation`: Estimates credits for a request.
- `generate_image`: Starts an image generation.
- `generate_video`: Starts a video generation.
- `list_tasks`: Lists generation tasks.
- `get_task`: Gets one task and its outputs.

## FAQ

### Which clients are supported?

Codex, Claude Code and Cursor as a local MCP server, plus direct CLI use.

### What does it need?

Node 22 or newer on macOS or Linux, including WSL.

### What happens if my access expires?

New generations and token refreshes need a subscription or top-up; tasks already created keep running.

### How do I disconnect?

Run wan27 auth logout. Changing your website password revokes every connection.

### What licence is the client under?

MIT.

### Is Wan27 MCP — AI Image and Video Generation free?

No. Wan27 MCP — AI Image and Video Generation is a paid product. Paid plans start at $9.9 a month.

### How do I add Wan27 MCP — AI Image and Video Generation to Claude Code?

Run this command in your terminal: claude mcp add wan27-mcp -- npx -y @wan27/cli

### What are the best alternatives to Wan27 MCP — AI Image and Video Generation?

The closest alternatives to Wan27 MCP — AI Image and Video Generation are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, VfxSmith and ChartAnt.

## Where this comes from

- Description: written from the project's README and the project's website.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/wan27-mcp-ai-image-and-video-generation
