VIDIA MCP

¿Qué es esto? / What is this?

ES — VIDIA es un servicio de producción de video con IA: elige un paquete (una receta de producción), escribe un tema, y VIDIA redacta el guion y produce narración, imágenes, clips de video con IA y subtítulos. Con este servidor MCP, los agentes de IA pueden obtener una cotización, iniciar una producción después de que el usuario acepte, dar seguimiento a su progreso y descargar el video terminado.

EN — VIDIA is an AI video production service: pick a package (a production recipe), write a topic, and VIDIA writes the script and produces narration, images, AI video clips and subtitles. With this MCP server, AI agents can get a quote, start a production after the user agrees, follow its progress and download the finished video.

El servidor está alojado por VIDIA. The server is hosted by VIDIA.

https://vidia.kr/mcp

Inicio rápido / Quick start

1. Crear una clave de API / Create an API key

Crea una clave en vidia.kr/settings/api. Hay dos alcances. Create a key at vidia.kr/settings/api. Two scopes:

tools/list funciona sin clave; tools/call la verifica a partir de ese punto. tools/list works without a key; tools/call checks it.

2. Conexión / Connect

claude mcp add --transport http vidia https://vidia.kr/mcp --header "Authorization: Bearer YOUR_VIDIA_API_KEY"

{
  "mcpServers": {
    "vidia": {
      "command": "npx",
      "args": ["-y", "vidia-mcp"],
      "env": { "VIDIA_API_KEY": "YOUR_VIDIA_API_KEY" }
    }
  }
}

{
  "mcpServers": {
    "vidia": {
      "url": "https://vidia.kr/mcp",
      "headers": { "Authorization": "Bearer YOUR_VIDIA_API_KEY" }
    }
  }
}

{
  "servers": {
    "vidia": {
      "type": "http",
      "url": "https://vidia.kr/mcp",
      "headers": { "Authorization": "Bearer YOUR_VIDIA_API_KEY" }
    }
  }
}

[mcp_servers.vidia]
command = "npx"
args = ["-y", "vidia-mcp"]
env_vars = ["VIDIA_API_KEY"]

VIDIA_API_KEY=YOUR_VIDIA_API_KEY npx -y vidia-mcp

3. Pregunta / Ask

"Consígueme una cotización de VIDIA para un video corto de salud sobre por qué los bostezos son contagiosos." "Get me a VIDIA quote for a health shorts video about why yawns are contagious."

El agente muestra la cotización en el orden vidia_list_packages → vidia_get_package → vidia_quote; cuando el usuario acepta, inicia con vidia_start_run, luego verifica el progreso con vidia_get_run y recibe el enlace del resultado con vidia_get_downloads.

Herramientas / Tools

Consulta TOOLS.md para los formatos de entrada y salida. See TOOLS.md for arguments and results.

Salvaguardas / Safeguards

• Clave de prueba (vd_test_…): conéctate con ella para ensayar todo el flujo sin gastar puntos. En lugar de un video real, recibes un resultado de muestra después de unos 40 segundos y cada respuesta incluye test: true.

• Las apps que admiten OAuth pueden omitir este paquete: ingresa la dirección https://vidia.kr/mcp e inicia sesión con VIDIA (sin pegar claves).

• Las herramientas que retienen puntos son solo vidia_start_run, vidia_start_batch y las acciones add_budget y approve_price de vidia_run_action. Para iniciar una producción se necesitan un ID de cotización válido, un presupuesto, un idempotency_key y un confirm: true. Reintentar con el mismo idempotency_key nunca crea una segunda producción.

• Las claves con permiso run tienen un límite diario de producciones (últimas 24 horas). Puedes revocar la clave en cualquier momento.

• Cuando una producción se detiene (por ejemplo, esperando aprobación de presupuesto o confirmación), revisa pending y actions en la respuesta de seguimiento y resuélvela con vidia_run_action (también puedes continuar en la página web del proyecto). Puedes establecer límites de presupuesto por producción y por día, y una lista de IP permitidas por clave.

• Este paquete es un relé que transmite JSON-RPC tal cual. La clave solo se envía en el encabezado Authorization y se oculta en todas las salidas y mensajes de error.

• Connect with a test key (vd_test_…) to rehearse the whole flow for free: you get a sample result after about 40 seconds and every response carries test: true.

• Apps that support OAuth can skip this package: enter https://vidia.kr/mcp and sign in to VIDIA.

• Points are only held by vidia_start_run, vidia_start_batch and the add_budget / approve_price actions of vidia_run_action. Starting needs a valid quote id, a budget, an idempotency_key and confirm: true; retrying with the same idempotency_key never creates a second production.

• run keys carry a daily production limit and can be revoked at any time.

• When a run stops, read pending and actions in the run status and resolve it with vidia_run_action (or on the web project page). Keys can carry per-run and daily budget caps and an IP allowlist.

• This package only relays JSON-RPC. The key is sent in the Authorization header and redacted from all output.

Variables de entorno / Environment

API REST / SDK

Para usarlo directamente desde código, usa vidia-api. For code, use vidia-api.

Licencia

MIT