Generate AI images and videos, estimate generation costs, and manage media tasks through an AI assistant.
Also known as NotUsingGithub/wan27-mcp, wan27-mcp, @wan27/cli
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.1.3
- Last commit
- Oct 28, 2026
- License
- MIT
What is Wan27 MCP?
Wan27 generates AI images and videos, estimate generation costs, and manage media tasks through an AI assistant.
Summary generated from the project's README
About Wan27 MCP server
Wan27 MCP provides a bridge between AI assistants and the wan2-7.io media generation platform. It allows users to create images and videos through a local stdio server using tools like generate_image and generate_video. This server works on macOS or Linux systems and requires an active paid subscription to function, as it consumes the same credit balance used on the official website.
Developers can integrate this server into clients like Claude or Codex by registering the command via npx or the local CLI. The toolset includes specific functions to manage media workflows, such as estimate_generation for cost forecasting, list_models to view available options, and list_tasks to track progress. It also supports image-to-video workflows by allowing users to upload a frame and pass its URL to the model.
Security is handled through the macOS Keychain or a private file for credential storage. For automated environments, the WAN27_ACCESS_TOKEN can be used to provide an API token. While checking models or listing tools does not cost credits, any generation task requires an authorized account and a valid subscription.
What you can do with it
- 1Predicting media generation costsAsk your AI assistant to calculate how many credits a specific video request will consume before starting the process.
- 2Creating videos from text promptsInstruct an AI client to generate a five-second 720p video of a paper boat on a rainy street.
- 3Converting static images to videoProvide an image URL to the assistant to animate a specific scene using the image-to-video model.
- 4Monitoring active media tasksUse the assistant to check the status of ongoing or completed generation jobs.
Written from the project's README. Every use case is checked against a quote from it.
How to install Wan27 MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Wan27 MCP in Claude Code
$ claude mcp add wan27-mcp -- npx -y @wan27/cliInstall Wan27 MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"wan27-mcp": {
"command": "npx",
"args": [
"-y",
"@wan27/cli"
]
}
}
}Install Wan27 MCP in VS Code
.vscode/mcp.json
{
"servers": {
"wan27-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@wan27/cli"
]
}
}
}Install Wan27 MCP in VS Code CLI
$ code --add-mcp '{"name":"wan27-mcp","type":"stdio","command":"npx","args":["-y","@wan27/cli"]}'Install Wan27 MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"wan27-mcp": {
"command": "npx",
"args": [
"-y",
"@wan27/cli"
]
}
}
}Install Wan27 MCP in Codex
$ codex mcp add wan27-mcp -- npx -y @wan27/cliInstall Wan27 MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.wan27-mcp] command = "npx" args = ["-y", "@wan27/cli"]
Install Wan27 MCP in Gemini CLI
$ gemini mcp add -s user wan27-mcp npx -- -y @wan27/cliInstall Wan27 MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"wan27-mcp": {
"command": "npx",
"args": [
"-y",
"@wan27/cli"
]
}
}
}Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablenotusinggithub/wan27-mcp is public and reachablegithub.com/notusinggithub/wan27-mcp ↗Pass
- Package names this repository as its source@wan27/cli names notusinggithub/wan27-mcp as sourcenpmjs.com/package/@wan27/cli ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-28github.com/notusinggithub/wan27-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @wan27/cliPass
- No critical advisory in the package or its dependencies99 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubWan27 MCP and CLI — AI Image and Video Generation
Generate images and videos from your terminal or AI assistant with your wan2-7.io account. MCP and CLI spend the same credit balance as the website, at the same prices. Credits are topped up on the website.
Access requires an active paid subscription. Credit packs alone, free accounts and unpaid trials do not qualify. A subscription with auto-renew turned off keeps access until its paid period ends. Upgrade at https://wan2-7.io/pricing/.
Node 22+, macOS or Linux (including WSL).
Install
npm install -g @wan27/cli
Use
wan27 auth login
wan27 account
wan27 models
wan27 estimate --input request.json
wan27 create --input request.json --wait
wan27 download <taskId> --output result.mp4
wan27 auth logout
request.json examples:
{"modelId":"wan27-text-to-video","prompt":"A paper boat on a rainy street","durationSeconds":5,"resolution":"720p"}
{"modelId":"wan2.7-image","prompt":"A paper crane on a desk","resolution":"2K"}
For image-to-video, upload the first frame and pass its URL:
wan27 upload frame.png # {"url":"https://..."}
{"modelId":"wan27-image-to-video","prompt":"The crane takes off","imageUrl":"https://..."}
wan27 model <modelId> prints every option and its 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. Failed tasks are refunded automatically. 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).
WAN27_CONFIG_DIR changes that directory. WAN27_ACCESS_TOKEN accepts a
pre-issued API token for automation. Logging out revokes this connection;
changing your website password revokes every connection.
Connect an assistant (local MCP)
Sign in once with wan27 auth login, then register the stdio server:
codex mcp add wan27 -- wan27 mcp
claude mcp add wan27 -- wan27 mcp
Tools: account_status, list_models, get_model, estimate_generation,
generate_image, generate_video, list_tasks, get_task.
After signing in, clients that accept JSON configuration can launch the same stdio server with npx:
{
"mcpServers": {
"wan27": {
"command": "npx",
"args": ["-y", "@wan27/cli", "mcp"]
}
}
}
Read account status and estimate the cost before generating. Image and video generation spend your website credits.
Documentation and support
- Wan27 website
- MCP setup and client instructions
- CLI installation
- MCP and CLI workflow guide
- Subscription plans
- Public client distribution and issue tracker
Run this public distribution
This repository contains the readable JavaScript executable for
@wan27/cli@0.1.3.
The hosted service is operated at wan2-7.io.
npm ci --ignore-scripts
node dist/cli.mjs --help
node dist/cli.mjs auth login
node dist/cli.mjs mcp
License and provenance
MIT. See PROVENANCE.md for release provenance. The executable is unchanged from 0.1.1. Version 0.1.3 updates the GitHub repository and MCP Registry namespace to the NotUsingGithub account.
Container for directory introspection
docker build -t wan27-mcp .
docker run --rm -i wan27-mcp
The container runs the same pinned client distribution as the npm package,
with the required mcp subcommand, as a non-root user. Linux containers explicitly select the private-file credential
store because macOS Keychain is unavailable there; the empty container has no
credentials. It accepts MCP JSON-RPC
on stdin and writes protocol responses on stdout. MCP initialization and
tools/list do not require an account or token and do not create media or spend
credits. Calling account or generation tools requires an authorized Wan27
account; generation still requires a paid subscription and spends website credits.
The build copies only the distribution and public metadata. No credentials or host configuration are included. Do not embed a token in the Dockerfile or image.
Wan27 MCP questions
How do I add Wan27 MCP to Claude Code?
Run claude mcp add wan27-mcp -- npx -y @wan27/cli in your terminal. Add --scope user to make it available in every project.
How do I add Wan27 MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Do I need a subscription to use Wan27?
Yes, access requires an active paid subscription. Credit packs, free accounts, and unpaid trials do not qualify.
How are credits charged for MCP and CLI usage?
MCP and CLI usage consumes the same credit balance and follows the same pricing as the Wan27 website.
What happens if a generation task fails?
Failed tasks are automatically refunded.
Can I estimate the cost before generating media?
Yes, you can use the estimate tool to check costs before starting a generation.