Skip to main content
Glama

⭐ 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:

npx -y -p short-video-agent-kit short-video-mcp --http
# GET  http://127.0.0.1:3033/health
# POST http://127.0.0.1:3033/mcp   (sessionless)

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.

Related MCP server: ai-promo-video

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

npm install -g short-video-agent-kit

Or run directly:

npm exec --yes --package=short-video-agent-kit -- short-video-agent-kit doctor

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:

short-video-agent-kit generate \
  --provider openai_sora \
  --prompt "Vertical 8-second product teaser for a minimalist water bottle, soft studio light, slow dolly-in" \
  --output ./output/teaser.mp4

Real output (no provider call, no credits spent):

{
  "ok": true,
  "dry_run": true,
  "next_step": "Pass --live or set SHORT_VIDEO_DRY_RUN=false to call the provider API.",
  "provider": "openai_sora",
  "endpoint": "POST /v1/videos",
  "payload": {
    "model": "sora-2",
    "prompt": "Vertical 8-second product teaser for a minimalist water bottle, soft studio light, slow dolly-in",
    "seconds": "8",
    "size": "720x1280"
  }
}

Same prompt, different provider — the plan re-targets the endpoint and parameter shape for you. payload returns just the plan (no dry_run wrapper):

short-video-agent-kit payload --provider gemini_veo --prompt "Same teaser, 9:16, cinematic"
{
  "provider": "gemini_veo",
  "endpoint": "POST /models/{model}:predictLongRunning",
  "payload": {
    "instances": [
      {
        "prompt": "Same teaser, 9:16, cinematic"
      }
    ],
    "parameters": {
      "aspectRatio": "9:16",
      "durationSeconds": 8
    }
  }
}

Check which providers are wired up (keys are detected, never printed):

short-video-agent-kit doctor
{
  "ok": false,
  "dry_run": true,
  "providers": {
    "openai_sora": { "configured": false, "env_keys": ["OPENAI_API_KEY"], "models": ["sora-2"] },
    "gemini_veo": { "configured": false, "env_keys": ["GEMINI_API_KEY", "GOOGLE_API_KEY"], "models": ["veo-3.1-fast-generate-preview"] },
    "xai_grok": { "configured": false, "env_keys": ["XAI_API_KEY"], "models": ["grok-imagine-video", "grok-imagine-image"] },
    "seedance_piapi": { "configured": false, "env_keys": ["PIAPI_KEY", "SEEDANCE_API_KEY"], "models": ["seedance-2-fast-preview"] }
  },
  "output_dir": "./output",
  "next_steps": [
    "Set one provider key: OPENAI_API_KEY, GEMINI_API_KEY, XAI_API_KEY or PIAPI_KEY."
  ]
}

When you are ready to actually render, set a provider key and re-run generate with --live (or SHORT_VIDEO_DRY_RUN=false).

CLI

short-video-agent-kit manifest --client codex
short-video-agent-kit doctor
short-video-agent-kit privacy-audit
short-video-agent-kit payload --provider gemini_veo --prompt-file prompt.txt
short-video-agent-kit generate --provider openai_sora --prompt "Vertical product teaser" --output ./output/teaser.mp4
short-video-agent-kit generate --provider openai_sora --prompt-file prompt.txt --output ./output/teaser.mp4 --live

Supported providers:

  • openai_sora

  • gemini_veo

  • xai_grok

  • seedance_piapi

MCP

short-video-mcp

HTTP transport:

SHORT_VIDEO_MCP_TRANSPORT=http short-video-mcp

Hermes-style config:

mcp_servers:
  short_video:
    command: npx
    args: ["-y", "short-video-agent-kit"]
    sampling:
      enabled: false

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

short_video_generate

Dry-run by default, live only when explicitly requested

Copy-Paste Agent Prompt

Use short-video-agent-kit. First call short_video_connection_status and short_video_privacy_audit.
Build the payload before generation. Only set live=true if I explicitly confirm a paid provider call.

Configuration

Copy .env.example to .env and fill only the provider keys you plan to use. .env, output/ and .agent-data/ are ignored by Git.

Safety Model

  • Dry-run is the default.

  • API keys are never returned by tools.

  • Paid generation requires --live, MCP live=true, or SHORT_VIDEO_DRY_RUN=false.

  • Reference images must be user-owned or licensed.

  • Outputs are written to local paths controlled by the user.

Development

npm install
npm test
npm run check

📧 Contact & Support

Available Tools

5 tools
short_video_agent_manifestShort Video Agent ManifestC
Read-onlyIdempotent

Machine-readable install, provider, runtime and safety guidance for agents.

Inputs: client, response_format.

short_video_build_payloadBuild Short Video PayloadB
Read-onlyIdempotent

Build a provider-specific request payload without calling the paid provider API.

Inputs: prompt (required), live, size, model, +10 more.

short_video_connection_statusShort Video Connection StatusB
Read-onlyIdempotent

Check configured providers and dry-run mode without exposing API keys.

Inputs: response_format.

short_video_generateGenerate Short VideoB

Generate one vertical video. Returns a dry-run payload unless live=true or SHORT_VIDEO_DRY_RUN=false.

Inputs: prompt (required), live, size, model, +10 more.

short_video_privacy_auditShort Video Privacy AuditC
Read-onlyIdempotent

Return prompt, asset, output and provider-key safety boundaries.

Inputs: response_format.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool targets a distinct aspect of short video generation: configuration, payload construction, connectivity, generation, and privacy. No overlapping purposes.

    Naming Consistency4/5

    All tools share the 'short_video_' prefix and follow a noun/verb_noun pattern, though 'generate' is a lone verb while others have two words. Minor deviation but overall clear.

    Tool Count5/5

    5 tools is well-scoped for a focused agent kit covering setup, execution, and safety. No unnecessary tools.

    Completeness4/5

    Covers core lifecycle: metadata, payload, connectivity, generation, and privacy. Missing post-generation actions (e.g., list, delete) but acceptable for an agent kit.

    Maintenance

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers