---
name: viibeo-faceless-shorts
description: Create, poll, and export faceless TikTok/Reels/Shorts videos via the Viibeo MCP API. Use when the user wants AI-generated short-form video without filming, or to automate Viibeo from Cursor/Claude.
---

# Viibeo faceless shorts (MCP)

Generate faceless short-form video (script → voiceover → visuals → captions) through Viibeo’s MCP endpoint. Autopilot (TikTok / Instagram auto-post) is configured in the Viibeo dashboard on Starter+; agents create and export one-off shorts here.

## Prerequisites

1. Viibeo account: https://viibeo.com/login
2. API key: Dashboard → Settings → API Keys (prefix `vii_`)
3. Credits on the account (free watermarked exports; Lite+ for clean MP4)

## Connect (Cursor / Claude Desktop)

HTTP MCP endpoint:

```json
{
  "mcpServers": {
    "viibeo": {
      "url": "https://viibeo.com/api/mcp",
      "headers": {
        "Authorization": "Bearer vii_YOUR_API_KEY"
      }
    }
  }
}
```

Docs: https://viibeo.com/agents

## Workflow (one short)

1. `get_my_credits` — confirm balance.
2. `create_short` with a concrete niche prompt (not “make a viral video”).
3. Poll `get_generation_status` with `jobId` until `COMPLETED` (or failed).
4. `start_export` with `videoId`.
5. Poll `get_render_status` until the render URL is ready.
6. Tell the user to download / post, or open Autopilot in the dashboard for scheduled TikTok/Instagram posting.

## Prompt tips

- One niche, one claim, one hook style.
- Prefer 15s–45s for first tests.
- Example: “True crime: three facts about the 1890s poison ring that sound fake but are documented. Faceless documentary tone.”

## Tools available

- `create_short` / `create_story`
- `get_generation_status`
- `list_my_videos` / `get_video`
- `start_export` / `get_render_status`
- `get_my_credits`
- `list_autopilot_series` (read-only — create series in the app)

## Limits

- Do not invent publish success; Autopilot posting is not an MCP write tool yet.
- Free tier exports may be watermarked — say so if the user is on Free.
- Never print the full API key in chat logs.