Cliptude CLI + MCP

Generate videos from a saved template. Same account and credits as cliptude.com.

Set up

1. Install the CLI: run npm i -g @cliptude/cli.
2. Authenticate: run cliptude auth login and complete the sign-in in the browser it opens.
3. Install the companion skills: run npx skills add cliptude/cliptude --path mcp_server/skills (includes cliptude, cliptude-script, and cliptude-faceless).

From this repo without npm:

pip install -e .
cliptude auth login

Commands

cliptude templates
cliptude generate --template "Finance vector weekly" --title "Why index funds win" --prompt "why most retail traders underperform the S&P over 10 years, keep it for beginners" --duration 3-4
cliptude generate --template "Finance vector weekly" --title "Why index funds win" --script-file script.txt
cliptude generate --template "Finance vector weekly" --title "Why index funds win" --voiceover narration.mp3
cliptude status <job-id>

--title is required. Provide one of --prompt, --script / --script-file, or --voiceover. Never copy the title into --prompt. If you only have a topic, follow cliptude-script (web search → spoken narration → --script-file). --voiceover is a local audio file (same as create.html); it is transcribed and skips TTS — do not combine it with prompt/script. Optional --duration is a wizard bucket (3-4, 6-8, 10-12, …). Omit it to use the template duration, or the word-count estimate when you pass --script. Uploaded audio sets duration from the file. generate returns immediately (queued). Poll status.

Faceless Explainer on CLI/MCP defaults to --faceless-coding external (this session authors HTML). Pass --faceless-coding cliptude to let Cliptude code. REST omit still means Cliptude codes.

cliptude generate --template "My Faceless" --title "Why index funds win" --script-file script.txt
cliptude kit <job-id> --out ./kit.zip
cliptude submit-project <job-id> ./project.zip

MCP

Remote Streamable HTTP: https://mcp.cliptude.com/mcp (OAuth or Bearer).

cliptude-mcp

Unauthenticated POST /mcp returns 401 with WWW-Authenticate pointing at RFC 9728 metadata. Stdio never writes to stdout except JSON-RPC.