Vixdeo para agentes — API y MCP

Dirige tu idea o tu guion hasta el video terminado. Vixdeo es el productor de video con IA: convierte una idea o un guion en una pieza terminada — guion verificado, voz, música y visuales dirigidos escena a escena —, operable por personas y por agentes.

Vixdeo is an AI video producer: it directs an idea or a script into a finished, fact-checked video, and exposes the same grammar the human director uses to agents via MCP (Streamable HTTP, OAuth 2.1 with dynamic client registration) and a REST API. Everything an agent or a registry needs is linked below.

Enlaces

Cómo conectar

  1. Host con OAuth (claude.ai, Cursor, ChatGPT…): agregá https://vixdeo.com/v1/mcp como servidor MCP remoto; el host se registra solo y te lleva al consentimiento.
  2. Agente programático: creá una API key en Configuración → Acceso para agentes y mandá Authorization: Bearer vbp_live_…. Claude Code: claude mcp add --transport http vixdeo https://vixdeo.com/v1/mcp --header "Authorization: Bearer <key>".

La guía completa (la misma que /llms.txt)

# Vixdeo — Dirige tu idea o tu guion hasta el video terminado

> Vixdeo es un estudio de video dirigido por IA: le cuentas tu idea (o tu
> agente se la cuenta) y produce un video profesional, nativo de tu cultura —
> guion con hechos verificados, voz, música y visuales dirigidos — y lo
> publica. Pago por uso con billetera; el primer video es gratis.

Vixdeo es agent-native: el MISMO contrato que dirige un humano por chat lo
opera un agente por MCP o por API REST. Un agente puede llevar una pieza de la
idea al video terminado sin que una persona toque la pantalla.

## Para agentes (MCP)

- Endpoint: https://vixdeo.com/v1/mcp — JSON-RPC 2.0 sobre HTTP (MCP Streamable HTTP),
  protocolo 2025-06-18. Descriptor: https://vixdeo.com/.well-known/mcp.json
- Tools: `list_referents` (los formatos/estilos disponibles y qué producen),
  `generate_script` (idea → proyecto + guion; con `production.auto_produce`
  la línea sigue sola hasta el video), `get_project_status` (estado, por qué
  está bloqueada, qué hay stageado, runs, costo, URL del video final),
  `list_cast` (voces y presentadores nombrables por `@handle`),
  `get_project_vbp` (leer el blueprint), `list_ops` / `run_op` (TODAS las ops
  de edición del director humano: `set_scene_fields` y `set_visual`
  deterministas y $0; `rewrite_scene` / `tighten_hook` con LLM, cobradas como
  un turno de chat), `direct` (una instrucción en lenguaje natural al Director:
  el mismo turno del chat humano), `commit` (nueva versión), `produce`
  (arrancar la producción), `list_projects`. El agente diagnostica Y corrige.
- Material PROPIO del creador (una entrevista grabada, una foto, dron):
  `request_upload` (ticket de subida directa) → POST del archivo →
  `complete_upload` (declarás QUÉ muestra) → `assign_material` sobre una
  escena → `produce`. La misma «Mi Media» del Studio, con dos bocas.
- `generate_script` acepta tu PROPIO material (`source`: un guion cerrado que se
  narra verbatim, o un artículo a adaptar) y el reparto por `@handle` (`cast`:
  voz, presentador, en cámara). `finalVideoUrl` es un enlace firmado que se
  abre y se comparte fuera de la app durante 7 días.

### Cómo entrar

Dos vías, el mismo poder. Las dos se administran en la app: Configuración →
Acceso para agentes (https://vixdeo.com/settings).

1. **OAuth 2.1** (para hosts con discovery: claude.ai, Cursor, ChatGPT, SDKs).
   Agrega `https://vixdeo.com/v1/mcp` como servidor MCP remoto; el host se registra solo
   (RFC 7591), te manda a la pantalla de consentimiento y recibe un token.
   - Resource metadata (RFC 9728): https://vixdeo.com/.well-known/oauth-protected-resource/v1/mcp
   - Authorization server (RFC 8414): https://vixdeo.com/.well-known/oauth-authorization-server
   - PKCE S256 obligatorio · scopes `read` `write` · refresh con rotación.
2. **API key** (para agentes programáticos): `Authorization: Bearer vbp_live_…`.
   Se crea en Configuración → Acceso para agentes, con scopes y vencimiento.
   Claude Code: `claude mcp add --transport http vixdeo https://vixdeo.com/v1/mcp --header "Authorization: Bearer <key>"`

Sin credenciales el servidor responde 401 con `WWW-Authenticate:
resource_metadata=…` (spec MCP §Authorization). No hay rutas `/mcp`, `/sse`
ni `/mcp/sse`: sólo `/v1/mcp`.

## API REST

- OpenAPI v1: https://vixdeo.com/v1/openapi.json — producciones, webhooks firmados,
  idempotencia, límites `RateLimit-*`. Docs interactivas: https://vixdeo.com/v1/docs
- Quickstart (cURL · Python · JS): https://vixdeo.com/v1/quickstart.md
- Errores RFC 7807: cada `type` se abre en https://vixdeo.com/errors/<slug> (catálogo: https://vixdeo.com/errors)
- Misma credencial que el MCP (API key u OAuth token).

## Documentos para agentes y registros

- Esta guía en HTML (indexable): https://vixdeo.com/developers/agents
- `server.json` del registro oficial de MCP (com.vixdeo/vixdeo): https://vixdeo.com/server.json
- Descriptor propio: https://vixdeo.com/.well-known/mcp.json

## Producto

- Landing: https://vixdeo.com/welcome — qué es Vixdeo y el modelo de precios
  (primer video gratis → pago por uso → bono por recarga).
- Explorador: https://vixdeo.com/explorer — obras reales publicadas por creadores reales.
- Registro: https://vixdeo.com/register