vugola-mcp

Official MCP server for Vugola — the AI video clipping tool.

Let Claude (or any MCP-capable agent) clip videos, check your credits, and schedule posts on your Vugola account.

---

Requires

• Node.js 20 or higher.
• A paid Vugola account. Generate a key at vugolaai.com/dashboard/api-key.

---

Install

Claude Desktop (one command, auto-configures)

npx vugola-mcp@1.3.0 install

npx will ask to install the package (type y), then the installer prompts for your API key. It edits your Claude Desktop config for you — no JSON to hand-write. Quit and reopen Claude Desktop to pick up the change.

To skip the key prompt: npx vugola-mcp@1.3.0 install --key vug_sk_yourkey.

Claude Code

claude mcp add vugola -- npx -y vugola-mcp@1.3.0

Then export your key in your shell or .env:

export VUGOLA_API_KEY=vug_sk_your_key_here

Cursor / Cline / manual

If your MCP client isn't covered above, drop this block into its config file:

{
  "mcpServers": {
    "vugola": {
      "command": "npx",
      "args": ["-y", "vugola-mcp@1.3.0"],
      "env": { "VUGOLA_API_KEY": "vug_sk_your_key_here" }
    }
  }
}

Always pin the version (vugola-mcp@1.1.0) — never install latest.

---

Tools

clip_video

Start a clipping job. Takes 10–30 minutes. Vugola emails you when it's done.

Inputs: video_url, aspect_ratio (9:16 | 16:9 | 1:1), caption_style (none | highlighted | scale | minimalist | box).

get_clip_status

Check a running job. Agent calls this when you ask "is that clip done?"

Inputs: job_id.

get_usage

Show credits remaining, monthly usage, and plan.

No inputs.

schedule_post

Schedule one or more social posts. Supports x, instagram, tiktok, youtube, facebook, linkedin, threads, bluesky.

Inputs: posts[] (max 25 per call). See the tool description for full fields.

list_scheduled_posts

List what's on your posting calendar. Optional filters for status (scheduled / processing / posted / failed), platform, limit, offset.

cancel_scheduled_post

Cancel a scheduled post before it goes live. Only works for posts in scheduled state.

Inputs: post_id.

download_clip

Save a completed clip to your local ~/Downloads/ folder and return the file path. Call after get_clip_status reports a job is complete.

Inputs: job_id, clip_index (1-based). Max 500 MB.

caption_video

Add captions to a short video (up to 5 minutes). No clipping, no reframing — just captions burned on top of the source video at source quality.

Inputs: video_url, aspect_ratio (9:16 | 16:9 | 1:1), caption_style (none | highlighted | scale | minimalist | box). Optional: caption_color (hex).

---

Security

• Never commit your VUGOLA_API_KEY. Your agent's config file contains a secret. Add it to .gitignore, or use a secrets manager (1Password CLI, direnv) instead of inline env vars.
• Always pin the version (vugola-mcp@1.0.0) in your install. Don't install "latest."
• If you accidentally leak your key, regenerate it at vugolaai.com/dashboard/api-key immediately.
• Download URLs returned by get_clip_status require the same Authorization: Bearer <key> header and expire in ~1 hour. Save clips promptly or re-fetch the status before downloading.

---

Pricing

This MCP requires a paid Vugola account (Creator plan or above). See pricing.

---

Links

• Vugola: https://www.vugolaai.com
• Dashboard: https://www.vugolaai.com/dashboard/api-key

---

License

MIT © 2026 Vadim Strizheus