# vugola-mcp

**Category:** 🎥 Multimedia Process  
**Repository:** https://github.com/VCoder25/vugola-mcp  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/vugola-mcp

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

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "vugola-mcp": {
    "command": "npx",
    "args": ["-y","vugola-mcp"]
  }
}
```

## Documentation & README

# vugola-mcp

Official MCP server for [Vugola](https://www.vugolaai.com) — 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](https://www.vugolaai.com/dashboard/api-key).

---

## Install

### Claude Desktop (one command, auto-configures)

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

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

Then export your key in your shell or `.env`:

```bash
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:

```json
{
  "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.

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

### `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` | `staticbox` | `glow` | `hormozi`). 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.3.1`) in your install. Don't install "latest."
- If you accidentally leak your key, regenerate it at [vugolaai.com/dashboard/api-key](https://www.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](https://www.vugolaai.com/pricing).

---

## Links

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

---

## License

MIT © 2026 Vadim Strizheus