Today we’re launching the Golpo MCP Server — the official plug-in that drops Golpo video generation straight into your favorite AI tool. If you live in Cursor, Claude Code, VS Code, Claude Desktop, or Visual Studio, you can now make a finished, narrated, animated explainer video by chatting. No API code. No dashboards. No SDK to import.
Just say:
“Make a 30-second Golpo video about why the sky is blue.”
… and an MP4 lands on your computer a few minutes later. Setup takes 2–5 minutes the first time. The plug-in is free, MIT-licensed, and open-source on GitHub and PyPI.
What is MCP in plain English?
Modern AI tools support something called MCP (Model Context Protocol). Don’t worry about the acronym — all it means is that your AI assistant can plug into outside services. Golpo MCP Server is that plug-in for Golpo. Once installed, your AI tool can:
- generate Golpo videos from prompts, scripts, audio files, or documents,
- save the finished MP4 to your computer automatically,
- show you a shareable link,
- list and re-download your past videos.
You won’t run a separate program named mcp or golpo. After setup, you just chat normally — no terminal commands needed for everyday use.
Step 0 — Get a Golpo API key
API access is gated behind specific Golpo plans. There are three ways to get a key:
- Scale plan — $999.99/month, includes 800 video minutes and full platform + API access. Best if your team uses both the dashboard and code at meaningful volume.
- Business plan + API add-on — Business plan ($499.99/month) plus a $200/month API add-on. Best if you’re already on Business and the API is secondary.
- API-Only plan — $200/month minimum, then pure usage-based. Cheapest entry, no commitment beyond the minimum, and you pay only for videos you generate. API-Only also runs automatic top-up: when your balance drops below $25, your account refills automatically so generation never halts mid-pipeline. You can pause it any time from the API dashboard.
Once you’ve picked a plan, grab the key:
- Scale or Business + API add-on: green Create API Key button in the top-right of the playground header at video.golpoai.com/playground.
- API-Only: blue + Create API Key button in the API Documentation section of the dedicated dashboard at video.golpoai.com/api-dashboard.
Copy the key the moment it appears — Golpo shows it once. A password manager is the ideal home for it. Full plan + pricing detail: How to Get Golpo AI API Access.
Step 1 — Install uv (one time, all tools)
uv is a tiny tool that downloads and runs the Golpo plug-in for you. You only install it once.
Mac / Linux — open Terminal and paste:
curl -LsSf https://astral.sh/uv/install.sh | sh
Windows — open PowerShell and paste:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
Close and reopen your shell, then run uv --version to confirm.
Step 2 — Install Golpo in your AI tool
Pick your tool. All paths replace YOUR_KEY with your real Golpo API key.
Cursor — one click
Click the deeplink, your browser will prompt “Open in Cursor?”, paste your API key in the confirmation dialog, click Install, then quit and reopen Cursor.
👉 Copy/Paste on your browser address bar: cursor://anysphere.cursor-deeplink/mcp/install?name=golpo&config=eyJjb21tYW5kIjogInV2eCIsICJhcmdzIjogWyJnb2xwby1tY3AiXSwgImVudiI6IHsiR09MUE9fQVBJX0tFWSI6ICJZT1VSX0tFWV9IRVJFIn19
Doesn’t open? Cmd+Shift+P → “MCP” → “Settings: Open MCP Settings” → Add Server, then paste:
{
"command": "uvx",
"args": ["golpo-mcp"],
"env": { "GOLPO_API_KEY": "your-key-here" }
}
Claude Code — one command
claude mcp add --transport stdio --scope user \
--env GOLPO_API_KEY=your-key-here \
golpo -- uvx golpo-mcp
You’ll see “Added stdio MCP server golpo.” No restart needed. Verify with claude mcp list — you should see golpo with ✓ Connected.
VS Code (with GitHub Copilot) — one command
Requires GitHub Copilot installed and signed in:
code --add-mcp '{"name":"golpo","command":"uvx","args":["golpo-mcp"],"env":{"GOLPO_API_KEY":"your-key-here"}}'
VS Code will open and ask you to confirm — click Install. Then open Copilot Chat, switch the mode dropdown to Agent, and click the 🔧 tools icon — you should see six Golpo tools.
Claude Desktop (Mac) — one paste
Open Terminal and paste this whole block (after substituting your key):
GOLPO_API_KEY="your-key-here" python3 - <<'PY'
import json, os, pathlib
p = pathlib.Path.home() / "Library/Application Support/Claude/claude_desktop_config.json"
p.parent.mkdir(parents=True, exist_ok=True)
cfg = json.loads(p.read_text()) if p.exists() and p.stat().st_size else {}
cfg.setdefault("mcpServers", {})["golpo"] = {
"command": "uvx",
"args": ["golpo-mcp"],
"env": {"GOLPO_API_KEY": os.environ["GOLPO_API_KEY"]},
}
p.write_text(json.dumps(cfg, indent=2) + "\n")
print(f"OK -> {p}")
PY
Quit Claude Desktop (Cmd+Q) and reopen. Click the 🔌 plug icon near the chat input — Golpo should be listed with six tools.
Claude Desktop (Windows) — one paste
Open PowerShell and paste the equivalent script (full version in the official install guide). It writes to %APPDATA%\Claude\claude_desktop_config.json. Quit Claude Desktop and reopen.
No Python on Windows? Open the file in Notepad and paste:
{
"mcpServers": {
"golpo": {
"command": "uvx",
"args": ["golpo-mcp"],
"env": { "GOLPO_API_KEY": "your-key-here" }
}
}
}
Visual Studio (Windows) — save a JSON file
For Visual Studio 2022 17.14+ with the GitHub Copilot extension. Save the following as .mcp.json in your user folder (typically C:\Users\YourName\.mcp.json), restart Visual Studio, and switch Copilot Chat to Agent mode:
{
"servers": {
"golpo": {
"type": "stdio",
"command": "uvx",
"args": ["golpo-mcp"],
"env": { "GOLPO_API_KEY": "your-key-here" }
}
}
}
How to actually use it
After install, you don’t run any commands. You just chat with your AI tool in Agent mode — the AI decides which Golpo tool to call.
Important: in Cursor, VS Code, and Visual Studio, MCP tools only work when the chat is in Agent mode. Look for the mode toggle near the chat input. In Claude Code and Claude Desktop, this is automatic.
Some prompts to try:
- Quick explainer: “Make a 30-second Golpo video about why the sky is blue.”
- Vertical short for social: “Make a vertical Golpo short about coffee, with the Sharpie style.”
- Your own script: “Here’s a script. Make a Golpo video out of it: Plants are nature’s solar panels…”
- Document → video: “Summarize this PDF as a 1-minute Golpo video: /path/to/report.pdf”
- Your own narration: “Use this audio file as narration for a Golpo video about machine learning: /path/to/voice.mp3”
- Browse history: “List my last 5 Golpo videos and show their links.”
- Re-download: “Download Golpo video with ID 88db3281-…”
Where do the videos go?
By default, finished MP4s are saved to:
- Mac / Linux: ~/Golpo/videos/
- Windows: C:\Users\YourName\Golpo\videos\
Filenames sort by recency:
20260522-142030_why-is-the-sky-blue_a1b2c3d4.mp4
Want them somewhere else? Just say “save it to my desktop instead” — the AI will use the right folder.
Visual styles, languages, music
You can mix and match by saying it in plain English. Common visual styles:
- Whiteboard / sketch: “make it a sketch” or “Sketch Classic”
- Cleaner polished sketch: “Professional Clean style”
- Crayon, kid-friendly: “Crayon style”
- Bold marker drawn: “Sharpie style”
- Whiteboard with images: “Canvas Whiteboard”
- Magazine illustration: “Editorial style”
- Chalkboard: “Chalkboard style” or “Chalkboard Color” for the neon version
- Modern minimal, Playful, Technical: just name the style
Languages: Golpo speaks 44+ languages. Say “Make this video in Spanish” or “Hindi narration, English on-screen text.”
Background music: “Add lofi music” or “Add documentary background music.” Available beds: jazz, lofi, whimsical, dramatic, engaging, hyper, inspirational, documentary.
🔒 Keep your API key safe
Treat your Golpo API key like a password:
- Never paste it into a public chat, screenshot, support ticket, or shared document.
- Never commit it to a public repo. If you accidentally do, rotate it immediately at video.golpoai.com.
- Only install the Golpo MCP Server from the official GitHub repo or PyPI.
- When your AI tool asks to run a Golpo tool (especially generate_video), glance at the parameters before approving. Most AI tools show a confirmation dialog the first time.
The MCP server only sends your key to the official Golpo API at api.golpoai.com. It never phones home, logs your key, or shares it with third parties.
Troubleshooting cheat-sheet
- “I don’t see Golpo tools”: you didn’t fully restart the AI tool after install. Quit completely (Cmd+Q / Alt+F4) and reopen.
- Tools listed but nothing happens: you’re not in Agent mode. Switch the chat mode dropdown to Agent.
- Red dot next to Golpo in MCP settings: API key wrong, or uv not installed. Re-check the key; if still red, restart your computer after installing uv.
- Error missing_credential: the GOLPO_API_KEY didn’t make it through your config. Double-check the env block.
- Error http_401: API key is invalid or revoked. Mint a fresh one from the playground or API dashboard.
- Error http_403: your plan doesn’t include API access. Upgrade to Scale, Business + API add-on, or API-Only.
- First request after install is slow: uv is one-time downloading the plug-in (~30 seconds). Note that video generation itself still takes normal render time — a 1-minute video still takes about 1 minute.
- cannot find executable ‘uvx’: uv installed but your AI tool can’t see it. Close the AI tool, restart your computer, reopen.
Helpful articles
- How to Get Golpo AI API Access: Plans & Pricing — the three paths to a Golpo API key, where to find the Create API Key button on each, and the API-Only auto top-up details.
- How the Golpo API Works — the underlying API the MCP server speaks to, end-to-end.
- Golpo AI Video API in Python: 6 Working Payload Examples — for when you outgrow MCP and want to call the API directly.
- Generate AI Videos from Claude Code: The Golpo Skill Plugin — a parallel package specifically for Claude Code, a touch more conversational than the MCP server. Same API key.
Where to find us
- Source & docs: github.com/Golpo-AI/golpo-mcp
- PyPI: pypi.org/project/golpo-mcp
- Bugs & feature requests: github.com/Golpo-AI/golpo-mcp/issues
- Full Golpo API reference: video.golpoai.com/api-docs
- Support: founders@golpoai.com
FAQ
What is the Golpo MCP Server?
The official Model Context Protocol plug-in for Golpo. It lets modern AI tools (Cursor, Claude Code, VS Code with Copilot, Claude Desktop, Visual Studio) call Golpo video-generation tools directly. You chat in plain English; the MP4 lands on your computer.
Which AI tools support it?
Cursor, Claude Code, VS Code with GitHub Copilot, Claude Desktop on Mac and Windows, and Visual Studio 2022 17.14+ with the Copilot extension. MCP tools require Agent mode in Cursor, VS Code, and Visual Studio.
Which Golpo plan should I buy for MCP use?
Either buy Scale plan, Business plan with API add-on or API-Only plan. Details here
Is the MCP server free?
Yes — free, open-source, MIT-licensed. You only pay Golpo for the videos you generate.
Where are videos saved?
~/Golpo/videos/ on Mac/Linux and C:\Users\YourName\Golpo\videos\ on Windows by default. Tell the AI to save them elsewhere if you prefer.
