Enables cloud-based voiceover generation with realistic narration.
Offers cloud-based copywriting for generating brand scripts and storyboards.
Supplies city background images for the brand film.
Supplies city background images for the brand film.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@WayCast turn https://stripe.com into a brand film"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Turn any company's URL into a polished vertical brand‑film — script, voiceover, city backgrounds, final MP4 — without opening an editor.
Open‑source · self‑hosted · local‑first. No avatars, no stock‑footage clichés — clean institutional motion‑graphics. The AI agent driving it is the writer, so it runs with zero cloud keys if you want.
中文说明 → README.zh.md · MIT OR Apache‑2.0 · Node ≥ 22 · pre‑alpha
npx waycastai doctor # what your machine can do
npx waycastai make https://stripe.com --reuse-bg wjdigital # URL → brand package in ./brands/
npx waycastai render <slug> --quality standard # → ./output/*.mp4Everything lands in your folder. Prefer a UI? npx waycastai console → http://127.0.0.1:4178.
Related MCP server: auto_video_mcp
A 1080×1920, 8‑shot institutional brand film — cover → who‑we‑are → what‑we‑do → why → how → who‑it‑powers → beliefs → CTA — data‑driven from a reusable block library, EN + ZH, real‑voice narration, per‑shot city backgrounds.
Most "URL → video" tools are paid SaaS, or wrap a cloud API behind talking‑head avatars. WayCast is the opposite end:
WayCast | |
Agent‑native | Driven by Claude Code / any agent via MCP — the agent writes the storyboard itself, so good copy needs no LLM key |
Local‑first | Renders locally; bundled local TTS (Kokoro EN / CosyVoice ZH same‑voice clone, Apache‑2.0) — or BYO cloud key |
Zero‑dependency | Pure Node + ffmpeg. No framework lock‑in |
Style | Clean text‑motion brand films — no avatars, no random stock B‑roll |
Bilingual | English + 简体中文 first‑class (most OSS video tools are EN‑only) |
Yours | Self‑hosted, dual‑licensed, keys stay in your |
CLI / npx — npx waycastai make <url> → render.
Any coding agent — clone, point Claude Code at it; it reads CLAUDE.md and authors + renders the film itself. See docs/agent-usage.md.
MCP — claude mcp add waycast -- npx waycastai mcp → 7 tools (waycast_scrape / write_brand / render / …). See docs/mcp.md.
URL ─▶ scrape ─▶ brief (+brand color) ─▶ script (EN/ZH copy) ─▶ pick city images
▼
brand package (brand.json + storyboard.json + vo.json + bg)
▼
local TTS ─▶ retime to narration ─▶ render (hyperframes) ─▶ MP4Every stage has a keyless local/deterministic fallback and an optional BYO‑key upgrade. Anti‑fabrication is enforced — the copy only uses facts from the site.
Capability | Local (offline) | Cloud (BYO‑key) |
Voiceover (required, pick one) | Kokoro (EN) / CosyVoice (ZH) | OpenAI / ElevenLabs / Azure |
Copywriting | deterministic draft or the driving agent | Anthropic / OpenAI |
City images |
| Pexels / Unsplash |
Keys go in .env (.env.example). npx waycastai doctor shows what's ready. Full setup: docs/install.md.
Core pipeline (URL → standard MP4) is verified end‑to‑end via the local path. Cloud LLM/TTS/image adapters are implemented but not yet live‑tested; a one‑click Docker image for the local models is WIP; Windows is untested (use WSL). It's a self‑hosted dev tool, not a turnkey consumer app. Changelog: CHANGELOG.md.
Dual‑licensed MIT OR Apache‑2.0 — your choice. Third‑party components (local TTS models, fonts, CC‑BY sample images, GSAP via CDN) in NOTICE.
Early days — issues and ideas welcome. See CONTRIBUTING.md. If it's useful, a ⭐ helps others find it.
This server cannot be deployed
Create branded vertical video ads from ecommerce product URLs or product photos.
Turn a product URL into a narrated cinematic demo video, launch video, or deck.
Build, run, schedule, and publish AI video pipelines to YouTube and TikTok from any MCP client.
AI video producer: directs your idea or script into a finished, fact-checked video. MCP-native.
