davidmosiah/short-video-agent-kit

One agent-first CLI + MCP for short-form AI video. Sora · Veo · xAI · Seedance — dry-run by default, paid generation when explicitly enabled.
> ⭐ **If this agent-first tool helps your workflow, please star the repo.** Stars make this tooling easier for other builders to discover and help Delx keep shipping open infrastructure.
> 🧱 Part of the Delx agent stack — 15 open-source MCP servers across **body, reach and coordination**.
---
HTTP (v2 stateless)
Default is **stdio**. Optional Streamable HTTP — no session id, JSON responses, loopback only:
Env: SHORT_VIDEO_MCP_HOST, SHORT_VIDEO_MCP_PORT, SHORT_VIDEO_MCP_TRANSPORT=http.
Provider-neutral short-form AI video toolkit for agents. It gives Codex, Claude, Cursor, Hermes, OpenClaw and other MCP clients one interface for building dry-run payloads and, when explicitly enabled, generating vertical video through Sora/OpenAI, Gemini Veo, xAI/Grok and Seedance/PiAPI-style providers.
Use it when an agent needs one safe interface for prompt-to-video payload validation and optional paid generation across multiple providers.
Why It Is Agent-First
Video generation can be expensive and prompt-sensitive. This package makes agents start with safe steps:
- inspect provider readiness
- return privacy boundaries
- build payloads without spending credits
- require --live or SHORT_VIDEO_DRY_RUN=false before provider calls
- keep prompts and outputs in local user-controlled paths
Install
Or run directly:
Quickstart
No API key needed to try it — generation is dry-run by default, so the kit returns the exact provider-neutral plan it *would* send without spending a credit.
Build a Sora plan for an 8-second vertical teaser:
Real output (no provider call, no credits spent):
Same prompt, different provider — the plan re-targets the endpoint and parameter shape for you. payload returns just the plan (no dry_run wrapper):
Check which providers are wired up (keys are detected, never printed):
When you are ready to actually render, set a provider key and re-run generate with --live (or SHORT_VIDEO_DRY_RUN=false).
CLI
Supported providers:
- openai_sora
- gemini_veo
- xai_grok
- seedance_piapi
MCP
HTTP transport:
Hermes-style config:
Recommended first calls:
1. short_video_connection_status
2. short_video_privacy_audit
3. short_video_build_payload
4. short_video_generate
Agent Surfaces
| Tool | Purpose |
|---|---|
| short_video_agent_manifest | Install/runtime guidance for Codex, Claude, Cursor, Hermes and OpenClaw |
| short_video_connection_status | Provider readiness without API keys |
| short_video_privacy_audit | Prompt, output and reference-asset boundaries |
| short_video_build_payload | Provider-specific payload without paid generation |