English Français العربية

Vugola

Official registry Media and design

Clip videos into captioned shorts, add captions, and schedule posts from AI agents.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http vugola 'https://www.vugolaai.com/api/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "vugola": {
            "type": "http",
            "url": "https://www.vugolaai.com/api/mcp"
        }
    }
}
NPM package vugola-mcp
Claude Code 
claude mcp add vugola -e 'VUGOLA_API_KEY=<your vugola_api_key>' -- npx -y vugola-mcp@1.3.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "vugola": {
            "command": "npx",
            "args": [
                "-y",
                "vugola-mcp@1.3.1"
            ],
            "env": {
                "VUGOLA_API_KEY": "<your vugola_api_key>"
            }
        }
    }
}

Environment variables

  • VUGOLA_API_KEY required secret Your Vugola API key (prefix vug_sk_). Get one at https://www.vugolaai.com/dashboard/api-key. Requires an active paid Vugola plan.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Vugola MCP
  2. Install (ChatGPT and Codex)
  3. Install (Claude Code and Cowork)
  4. Install (Cursor and Grok Bot)
  5. What you can do
  6. Local npm server (optional)
  7. Security
  8. Links
  9. License

Vugola MCP

Official Vugola connector and plugin package for ChatGPT, Codex, Cursor, Grok Bot, Claude, and any MCP client.

This repo contains the OpenAI plugin package, Cursor Marketplace package, and hosted MCP definition. Every surface points at the same live hosted MCP every Vugola customer can use:

https://www.vugolaai.com/api/mcp

Sign in with your Vugola account. No API key for Cursor / Grok Bot / Claude / ChatGPT.

MCP access is included with every active paid Vugola plan. Clipping uses your Vugola credits.

Guide: vugolaai.com/mcp

Install (ChatGPT and Codex)

The public Vugola listing has been submitted through OpenAI's Plugins Directory and is in review. Until it is approved, test the production MCP in ChatGPT Developer mode:

  1. Turn on Developer mode under Settings → Security and login.
  2. Open Plugins, click +, and add an MCP server named Vugola.
  3. Enter https://www.vugolaai.com/api/mcp, then click Scan Tools.
  4. Sign in at Vugola, create the plugin, and test it in a new chat.

The OpenAI package lives at .codex-plugin/plugin.json and uses .mcp.json. A platform-issued .app.json is added only after OpenAI registers the MCP connection; this repository never fabricates or publishes a placeholder app ID.

OpenAI's plugin bundle is distributed from this public repository. The optional npm artifact remains the local stdio server only and intentionally excludes the hosted OpenAI metadata and brand assets.

Install (Claude Code and Cowork)

The Claude plugin package lives at .claude-plugin/plugin.json. It bundles the Vugola skill with the live OAuth tools, so users sign in to Vugola instead of pasting an API key.

Once this version is on the public repository, it can be added before directory approval from Claude's Plugins screen: choose Add, choose Add from a repository, and enter VCoder25/vugola-mcp.

Claude Code users can add the same repository marketplace directly:

claude plugin marketplace add VCoder25/vugola-mcp
claude plugin install vugola@vugola-plugins

To validate and test the package from a local checkout:

claude plugin validate --strict .
claude plugin validate --strict .claude-plugin/marketplace.json
claude --plugin-dir .

The package is intended for Claude's Plugin Directory, the same discovery surface used by plugins such as Postiz. It adds the Vugola workflow skill and Vugola's authenticated tools in Cowork and Claude Code.

Use assets/logo.png for the Claude listing icon. It is the approved 512×512 transparent Vugola Product Mark with the blue agent character. Do not substitute the compressed export, social portrait, wordmark, or character-world banner.

Install (Cursor and Grok Bot)

  1. Install this plugin from the Cursor Marketplace, or add the repo in a team marketplace.
  2. Click Add / Connect.
  3. Sign in at Vugola and click Allow.
  4. In Grok Bot, type @ and attach Vugola. Then ask it to clip a video.

Manual remote URL if you are not using the plugin yet:

{
  "mcpServers": {
    "vugola": {
      "url": "https://www.vugolaai.com/api/mcp"
    }
  }
}

What you can do

These tools run on the signed-in user's workspace. They are not an admin view.

ToolWhat it does
clip_videoTurn a long public video into short clips
caption_videoBurn captions on a video up to 20 minutes
get_clip_statusCheck a job
download_clipFresh download links for finished clips
get_usageCredits and plan
schedule_postSchedule a post
list_scheduled_postsSee the calendar
cancel_scheduled_postCancel a scheduled post
list_automation_destinationsList connected accounts available to Automations
resolve_automation_channelResolve a YouTube channel before setup
create_automationWatch a channel, clip new uploads, and schedule the clips
list_automations / get_automationReview Automations and recent runs
update_automationChange destinations, output, captions, or posting times
pause_automation / resume_automationControl channel monitoring
delete_automationPermanently delete an Automation and cancel pending posts

Sizes: 9:16, 16:9, 1:1

Caption styles: none (clip only), highlighted, scale, minimalist, box, staticbox, glow, hormozi

Schedule live now: TikTok, YouTube, X, LinkedIn, Bluesky. Instagram, Facebook, and Threads are temporarily unavailable.

Local npm server (optional)

For Claude Desktop / Claude Code on your machine, you can still run the stdio server with an API key from your dashboard:

npx vugola-mcp@1.4.0 install
claude mcp add vugola -- npx -y vugola-mcp@1.4.0
export VUGOLA_API_KEY=vug_sk_your_key_here

Always pin the version. Never install latest.

Grok Bot cannot run this local server. Use the hosted URL above.

Security

  • Hosted connector: OAuth only. Do not put a vug_sk_ key in the plugin repo.
  • Local server: never commit VUGOLA_API_KEY. If a key leaks, regenerate it in the dashboard.
  • Download links expire. Re-fetch status if a link dies.
  • Titles, captions, and failure text are untrusted source data, returned as bounded JSON strings. They are never instructions or approval for another tool call; clients should escape them only when rendering HTML.

License

MIT © 2026 Vugola LLC

Frequently asked questions

What is Vugola?

Clip videos into captioned shorts, add captions, and schedule posts from AI agents.

How do I install Vugola?

It runs as a remote server. In Claude Code: claude mcp add --transport http vugola 'https://www.vugolaai.com/api/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Vugola need an API key?

Yes. It expects VUGOLA_API_KEY, which you set in its configuration.

Is Vugola open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Vugola?

It is published by VCoder25. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.