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:
- Turn on Developer mode under Settings → Security and login.
- Open Plugins, click +, and add an MCP server named Vugola.
- Enter
https://www.vugolaai.com/api/mcp, then click Scan Tools.
- 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)
- Install this plugin from the Cursor Marketplace, or add the repo in a team marketplace.
- Click Add / Connect.
- Sign in at Vugola and click Allow.
- 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
License
MIT © 2026 Vugola LLC