--- name: usemo-brand-video description: Plan, quote, render, and retrieve brand-grounded talking-head videos, presenter reels, and digital-twin clips through UseMo MCP, CLI, or REST API. Use when creating asynchronous marketing or founder videos from a brief, script, starting frame, or enrolled twin; do not use for live conversational avatars, phone calls, or local-only processing. --- # UseMo Brand Video Workflow Complete asynchronous video jobs in a UseMo workspace while verifying workspace identity, quoting cost before spend, and handling asynchronous job recovery safely. Canonical references: - Agent & API guide: `https://usemo.com/agents` (`https://usemo.com/agents.md`) - Hosted MCP server: `https://api.usemo.com/mcp` - REST OpenAPI: `https://api.usemo.com/api/openapi.json` ## 1. Verify workspace, credits, and inputs first 1. Call `usemo_whoami` (MCP), `usemo whoami --json` (CLI), or `GET /api/v1/whoami` (REST) to confirm the connected workspace, active plan, `credits_remaining`, `concurrent_jobs`, and `max_video_length_sec`. 2. Call `usemo_get_brand_context` (`GET /api/v1/context/profile`) before drafting scripts or briefs. If brand context is empty and the user supplied their website URL, ingest it with `usemo_learn_context` (`POST /api/v1/context/sources/website`) and wait for completion. 3. If the user asks for an enrolled founder or presenter clone, call `usemo_list_twins` (`GET /api/v1/twins`) and verify `status == "ready"`. ## 2. Choose the right video route | User job | MCP tool | CLI command | REST endpoint | |---|---|---|---| | Brief to grounded storyboard (read-only, no render) | `usemo_plan_video` | `usemo videos plan "" --json` | `POST /api/v1/video/storyboard` | | Estimate tier prices before spending | `usemo_quote_cost` | `usemo videos quote --data @quote.json --json` | `POST /api/v1/video/scene-video/quote` | | One-shot brief to gated talking-head/presenter video | `usemo_create_video` | `usemo videos create "" --wait --json` | `POST /api/v1/video/create` | | Verbatim script to narrated/presenter video | `usemo_script_to_video` | `usemo videos script "