App marketplace / one-click connectors are not supported yet. Use manual setup below with an API Key.
Add VMEG to your agent (manual)
Get an API Key
Create a key on API Configuration. You need a paid plan with credits — see Pricing.
Add a custom MCP server
In your MCP-compatible agent, open Connectors or MCP servers and choose Add custom connector (not a marketplace listing).
Enter the endpoint and Bearer token
- Name:
VMEG - URL:
https://www.vmeg.ai/api/mcp - Authorization:
Bearer YOUR_API_KEY
What you can do
Once connected, your AI agent has access to the following tools:Materials
| Tool | Description |
|---|---|
vmeg_list_materials | List uploaded video/audio materials in your project. |
vmeg_delete_material | Delete an uploaded material. Requires explicit user confirmation. |
Voices
| Tool | Description |
|---|---|
vmeg_list_basic_voices | List system voices. Filter by locale (e.g. en-US, zh-CN). |
vmeg_list_clone_voices | List cloned voices in your project. |
Create tasks
| Tool | Description |
|---|---|
vmeg_create_video_translation_task | Create a video or audio translation task. Requires targetLanguage and one media source. |
vmeg_create_subtitle_translation_task | Create a subtitle translation task. Requires targetLanguage and one media source. |
Tasks
| Tool | Description |
|---|---|
vmeg_list_tasks | List recent tasks or poll a single task by taskId. |
vmeg_delete_task | Delete a task. Requires explicit user confirmation. |
Task draft (editor)
| Tool | Description |
|---|---|
vmeg_query_task_scripts | Query translated script lines. |
vmeg_query_task_subtitles | Query subtitle clips. |
vmeg_query_task_asr | Query ASR / original recognition lines. |
vmeg_query_task_speakers | Query speakers and voice assignments. |
vmeg_query_task_tracks | Query audio/video track blocks. |
vmeg_save_task_draft | Apply draft edits. Does not auto re-translate or export. |
vmeg_compose_task_draft | Render/export a new video or audio from the saved draft. |
Async follow-up
| Tool | Description |
|---|---|
vmeg_retranslate_task_scripts | Re-translate all scripts for an existing task. |
vmeg_get_retranslate_status | Poll re-translation status. |
vmeg_trigger_video_translation_all_tts | Re-dub all or selected scripts. |
vmeg_get_tts_status | Poll per-script TTS dubbing status. |
Upload (HTTP)
| Endpoint | Description |
|---|---|
POST /api/mcp/material/upload | Multipart upload for local files. Returns materialId for create-task tools. |
Media sources
Each create-task call needs exactly one source:| Source | When to use |
|---|---|
materialId | File already in your project (from upload or library) |
sourceUrl | HTTPS direct link — e.g. an agent attachment URL |
youtubeUrl | YouTube video URL only |
sourceUrl, pass a public HTTPS file URL. For local files, upload via POST /api/mcp/material/upload first.
Supported products
| Agent | Manual custom MCP | VMEG auth | Status |
|---|---|---|---|
| Cursor | Yes — mcp.json or Settings | API Key (Bearer) | Available |
| Claude | Yes — Add custom connector | OAuth on Connect | Available |
| Claude Code | Yes — claude mcp add | API Key or OAuth | Available |
| Gemini CLI | Yes — settings.json | API Key (Bearer) | Available |
| Manus | Yes — Custom MCP connector | API Key (Bearer only) | Available |
| ChatGPT | No | — | Coming soon |
Remote MCP
App marketplace
One-click installs from marketplaces or app stores are not supported yet. ChatGPT support is coming soon. For agents that support manual MCP, use manual setup with your API Key.
FAQ
Do I need an API Key?
Do I need an API Key?
For manual setup, yes — create an API Key and send it as
Authorization: Bearer on MCP requests. Some future marketplace connectors may use OAuth instead.Does this cost extra?
Does this cost extra?
No. Translation uses credits included in your VMEG plan. See Pricing.
Which plans support MCP?
Which plans support MCP?
Free and paid VMEG accounts can connect MCP. Submitting translation tasks deducts credits from your account as usual — see Pricing.
Can I use materials and voices from the vmeg.ai web app?
Can I use materials and voices from the vmeg.ai web app?
Yes. MCP binds to your VMEG project (via API Key or OAuth) and uses the same materials, tasks, and project resources as the website.
Are MCP and Open API assets interchangeable?
Are MCP and Open API assets interchangeable?
No. Materials, tasks, and
voiceId values created through the Open API are separate from MCP. Do not mix IDs across the two channels. See API assets.What's the difference between MCP and the Open API?
What's the difference between MCP and the Open API?
MCP exposes translation tools for AI agents (OAuth, VMEG project scope, shared with the web app). The Open API exposes REST endpoints for programmatic backends (API Key, separate asset store).