Google Vids MCP Server by useapi.net

Google Vids: video Omni de Gemini con sonido, avatares con voz, extensión, mejora de resolución, edición e imágenes. De terceros, de pago (15 $/mes), funciona con tu propia cuenta.

Ver en useapi.net

Servidor MCP alojado

npx add-mcp 'https://api.useapi.net/v1/google-vids/mcp'

Se instala en Claude Code, Codex, Cursor y más

Documentación

Saltar al contenido principal

Servidor MCP de Google Vids

16 de octubre de 2026

El servidor MCP de Google Vids de useapi.net permite que un asistente de IA como Claude Code, Cursor o VS Code Copilot cree videos con Google Vids en tus propias cuentas de Google. Es un servidor alojado de Model Context Protocol con 16 herramientas: genera clips de Gemini Omni 1.1 Flash con sonido y voz a partir de texto, una imagen inicial o hasta 3 referencias, extiende, mejora y edita clips, crea imágenes, sube tus propias fotos y crea avatares con voz que pronuncian las líneas que escribes. Cada herramienta llama a la API de Google Vids, por lo que se aplican las mismas reglas y límites. No es necesario instalar ni alojar nada.

¿Existe un servidor MCP de Google Vids? Sí. useapi.net, un servicio de terceros no afiliado a Google, aloja uno en https://api.useapi.net/v1/google-vids/mcp con 16 herramientas para video, imágenes y avatares con voz de Gemini Omni 1.1 Flash, en tu propio plan Google AI Pro o Ultra, sin nada que instalar.

¿Prefieres REST? Tutorial: Cómo hacer videos de influencers con IA y avatares mediante la API de Google Vids · Código: github.com/useapi/google-vids-api

Consulta todos los servidores MCP de useapi.net en Model Matrix & MCP.

Endpoint y autorización

https://api.useapi.net/v1/google-vids/mcp

Transporte: HTTP transmisible.
Listado en el Registro oficial de MCP como net.useapi/google-vids, por lo que los clientes y directorios de MCP que lean el registro pueden encontrarlo por ese nombre.
Autorización: tu token de API de useapi.net en el encabezado Authorization: Bearer …, consulta Configuración de useapi.net.
Necesitas al menos una cuenta de Google añadida con Configuración de Google Vids. Añadir y eliminar cuentas no está disponible a través de MCP: usa POST /accounts o la página de configuración.

Configuración

Reemplaza YOUR_API_TOKEN con tu token de API de useapi.net.

Claude Code

claude mcp add --transport http useapi-google-vids https://api.useapi.net/v1/google-vids/mcp --header "Authorization: Bearer YOUR_API_TOKEN"

Cursor

En ~/.cursor/mcp.json:

{
  "mcpServers": {
    "useapi-google-vids": {
      "url": "https://api.useapi.net/v1/google-vids/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

VS Code

En .vscode/mcp.json:

{
  "servers": {
    "useapi-google-vids": {
      "type": "http",
      "url": "https://api.useapi.net/v1/google-vids/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Windsurf y otros clientes

Cualquier cliente que admita servidores MCP remotos por HTTP con encabezados personalizados funciona. La forma JSON habitual:

{
  "mcpServers": {
    "useapi-google-vids": {
      "serverUrl": "https://api.useapi.net/v1/google-vids/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Algunos clientes llaman al campo de dirección url en lugar de serverUrl.

Pruébalo con curl

curl -s https://api.useapi.net/v1/google-vids/mcp \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1"}}}'

curl -s https://api.useapi.net/v1/google-vids/mcp \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

La primera llamada responde con el nombre del servidor useapi-google-vids y sus instrucciones para el asistente; la segunda, con las 16 herramientas.

Herramientas

Los clips, imágenes, subidas y avatares se nombran por los ids que devuelven las herramientas, y cada id lleva su cuenta, por lo que un seguimiento se ejecuta en la cuenta que contiene sus entradas. Las herramientas que inician un trabajo aceptan un email opcional para elegir la cuenta.

Cuentas

Herramienta	Qué hace	Parámetros principales
`vids_list_accounts`	Lista tus cuentas con estado, `maxJobs` y los límites mensuales del plan.
`vids_get_account`	Comprueba una cuenta en vivo: si está conectada o no, y cuánto queda de los segundos de video e imágenes de este mes.	`email`
`vids_update_account`	Establece `maxJobs`, los trabajos que una cuenta ejecuta a la vez.	`email`, `maxJobs`

Videos e imágenes

Herramienta	Qué hace	Parámetros principales
`vids_create_video`	Genera un clip de 3 a 10 segundos con sonido y voz a partir de texto, de una imagen inicial o de hasta 3 referencias (imágenes y avatares, nombrados en la indicación como `@referenceImage_1` o `@avatar_1`).	`prompt`, `duration`, `aspectRatio`, `resolution`, `startImage`, `referenceImage_1`..`3`, `avatar_1`..`3`, `email`
`vids_extend_video`	Añade de 3 a 10 segundos a un clip y devuelve el clip completo, hasta unos 41 segundos.	`mediaId`, `prompt`, `duration`
`vids_upscale_video`	Convierte un clip `720p` de hasta 20 segundos en `1080p`.	`mediaId`
`vids_edit_video`	Cambia un clip mediante indicación: colores, objetos, estilo.	`video`, `prompt`, `duration`
`vids_create_image`	Genera un JPEG en uno de 7 estilos, devuelto como imagen que el asistente puede ver.	`prompt`, `aspectRatio`, `style`, `email`
`vids_get_job`	Lee un trabajo y, con `wait: true`, espera a que termine.	`jobid`, `wait`
`vids_list_jobs`	Lista los trabajos en ejecución ahora y el recuento en ejecución de cada cuenta frente a `maxJobs`.

Los parámetros coinciden con POST /videos, POST /videos/extend, POST /videos/upscale, POST /videos/edit y POST /images.

Archivos, avatares y voces

Herramienta	Qué hace	Parámetros principales
`vids_upload_asset`	Sube tu propia imagen JPEG, PNG o WebP desde una URL https pública de hasta 50 MB, o enviada como `contentBase64`, y devuelve un `assetId` para `startImage` o `referenceImage_N`.	`url` o `contentBase64`, `mimeType`, `email`
`vids_get_media`	Comprueba un `mediaId` y devuelve su URL de descarga. Una imagen también vuelve como imagen que el asistente puede ver.	`mediaId`
`vids_list_voices`	Lista las 30 voces de Gemini con su estilo y audio de vista previa.
`vids_list_avatars`	Lista los avatares guardados en tus cuentas, incluidos los creados en la aplicación web de Google Vids.	`email`
`vids_create_avatar`	Crea un avatar con voz a partir de una descripción de la persona (`appearance`), que usa 1 imagen de la asignación de la cuenta, o a partir de una imagen creada con `vids_create_image`. Un avatar dibujado vuelve como imagen.	`name`, `voice`, `appearance`, `outfit`, `shot`, `expression`, `details`, `image`, `email`
`vids_delete_avatar`	Elimina un avatar.	`avatarId`

El esquema de entrada completo de cada herramienta proviene de tools/list.

Trabajo de larga duración

Los clientes de MCP suelen abandonar una llamada de herramienta después de aproximadamente un minuto, por lo que una herramienta espera hasta unos 50 segundos:

Una imagen suele terminar en unos 10 segundos, y la herramienta la devuelve.
Un clip 720p a menudo termina en ese tiempo. Un clip 1080p, una extensión, una mejora o una edición tarda más. La herramienta entonces devuelve el jobid, y vids_get_job con wait: true lo retoma. Pide al asistente que siga comprobando hasta que termine.
vids_create_avatar responde en unos 10 a 40 segundos.

Los clientes que solicitan notificaciones de progreso reciben una aproximadamente cada 10 segundos mientras una herramienta espera.

Los clips vuelven como un mediaId con una URL de descarga. Recupéralo con el mismo encabezado Authorization y descárgalo pronto, ya que Google solo conserva los archivos por un tiempo; consulta Cuánto duran los archivos.

Ejemplos de indicaciones

“Haz un clip de 10 segundos en 1080p de un zorro corriendo por un bosque nevado al amanecer.”
“Haz una foto de una bicicleta roja en una calle de Lisboa y luego conviértela en un clip donde alguien se la lleva montando.”
“Crea un avatar de una chef alegre de unos cincuenta años con la voz Neo, y luego haz un clip de retrato donde diga: ‘Hoy horneamos pan.’”
“Sube esta foto de producto y haz un clip de mi avatar sosteniéndola y hablando de ella.”
“Extiende el último clip 8 segundos con la cámara alejándose y luego mejóralo a 1080p.”
“¿Cuántos segundos de video quedan en mis cuentas de Vids este mes?”

Límites y notas

Las herramientas usan tus cuentas de Google y las mismas reglas que la API REST, como maxJobs. Los segundos de video y las imágenes cuentan contra la asignación mensual de Vids de la cuenta; consulta Planes y asignaciones mensuales.
Los conectores personalizados en claude.ai necesitan inicio de sesión OAuth, que este servidor aún no admite. Usa Claude Code u otro cliente que pueda enviar un encabezado Authorization.
Un cliente puede enviar hasta 20 solicitudes JSON-RPC en un lote.
Si el cliente envía un encabezado MCP-Protocol-Version, debe ser una de las versiones admitidas: 2025-06-18, 2025-03-26 o 2024-11-05.
Cada llamada de herramienta aparece en tus estadísticas de uso ( bot=google-vids) como modelo mcp, con el nombre de la herramienta como estado, o failed.

Tutoriales para la API de Google Vids v1:

{ "@context": "https://schema.org", "@type": "APIReference", "name": "Google Vids MCP Server: Gemini Omni Video and Voiced Avatars", "url": "https://useapi.net/docs/api-google-vids-v1/mcp", "inLanguage": "en", "isAccessibleForFree": true, "description": "Connect Claude Code, Cursor, VS Code or any MCP client to the hosted useapi.net Google Vids MCP server: 16 tools for Omni 1.1 Flash video, images and voiced avatars.", "about": "Google Vids API v1", "isPartOf": { "@type": "APIReference", "name": "Google Vids API v1" }, "publisher": { "@type": "Organization", "name": "useapi.net", "url": "https://useapi.net", "logo": { "@type": "ImageObject", "url": "https://useapi.net/assets/brand/useapi-logo-512.png" }, "alternateName": ["useapi", "UseAPI"], "sameAs": ["https://discord.gg/w28uK3cnmF", "https://t.me/use_api", "https://github.com/useapi", "https://bsky.app/profile/useapi.net", "https://www.youtube.com/@useapi-net"] }, "documentationOf": { "@type": "WebAPI", "name": "useapi.net REST API", "documentation": "https://useapi.net/llms.txt", "termsOfService": "https://useapi.net/docs/legal" } }
{ "@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://useapi.net/" }, { "@type": "ListItem", "position": 2, "name": "Google Vids API v1", "item": "https://useapi.net/docs/api-google-vids-v1" }, { "@type": "ListItem", "position": 3, "name": "MCP Server", "item": "https://useapi.net/docs/api-google-vids-v1/mcp" } ] }