📦

io.github.VCoder25/vugola-mcp

Official Vugola MCP server - AI video clipping and multi-platform post scheduling.

0 installs

Trust: 37 — Low

Commerce

Ask AI about io.github.VCoder25/vugola-mcp

I know everything about io.github.VCoder25/vugola-mcp. Ask me about installation, configuration, usage, or troubleshooting.

0/500

Loading tools...

Reviews

Documentation

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.1 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.1 install --key vug_sk_yourkey.

Claude Code

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

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.1"],
      "env": { "VUGOLA_API_KEY": "vug_sk_your_key_here" }
    }
  }
}

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

Tools

`clip_video`

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

`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.

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.3.1) 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.