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.

Tool	What it does
clip_video	Turn a long public video into short clips
caption_video	Burn captions on a video up to 20 minutes
get_clip_status	Check a job
download_clip	Fresh download links for finished clips
get_usage	Credits and plan
schedule_post	Schedule a post
list_scheduled_posts	See the calendar
cancel_scheduled_post	Cancel a scheduled post
list_automation_destinations	List connected accounts available to Automations
resolve_automation_channel	Resolve a YouTube channel before setup
create_automation	Watch a channel, clip new uploads, and schedule the clips
list_automations / get_automation	Review Automations and recent runs
update_automation	Change destinations, output, captions, or posting times
pause_automation / resume_automation	Control channel monitoring
delete_automation	Permanently 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.3.1 install

claude mcp add vugola -- npx -y vugola-mcp@1.3.1
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.

---

Links

• Product: https://www.vugolaai.com
• MCP guide: https://www.vugolaai.com/mcp
• Pricing: https://www.vugolaai.com/pricing
• Samples: https://www.vugolaai.com/samples

---

License

MIT © 2026 Vugola LLC