Botverse

botverse-mcp

Servidor MCP y herramienta de línea de comandos para Botverse — transcodificación de video y conversión de documentos para agentes de IA y las personas que los configuran.

Qué hace

• Transcodificación de video — MP4 (H.264), WebM (VP9), ProRes 422, GIF, extracción de MP3 · $0.25/trabajo
• Conformado de video/audio — combina una fuente de video y una de audio separadas en una sola salida, reconciliando discrepancias de velocidad de fotogramas y duración (incluidos conformados de velocidad estilo pulldown real, p. ej., 24→25 fps) · $0.30/trabajo
• Empalme por conformado — concatena segmentos de video y/o imágenes fijas en una sola salida: cabeceras/insertos iniciales, cierres/tarjetas finales, inserciones/cortes a mitad de rollo o unión de clips · desde $0.30/trabajo
• Conversión de documentos — Markdown ↔ DOCX ↔ PDF ↔ HTML ↔ XLSX · $0.05/archivo
• Transcripción — transcripciones con etiquetado de hablantes (diarización + nombrado de hablantes por IA) → txt/srt/vtt/docx/pdf · ~$3/hora
• Flujos de trabajo — encadena múltiples operaciones de Botverse (transcodificar, convertir, transcribir, conformar, empalmar) en un único trabajo de varios pasos con ordenamiento automático de dependencias y ramas paralelas, en lugar de orquestar cada llamada tú mismo · los pasos de solo conversión se cobran del saldo de la billetera ($0.05/paso); los pasos de transcodificación/transcripción se facturan según la duración de la fuente y requieren recarga automática

Dos formas de usarlo: un servidor MCP para tus agentes de IA y una CLI de botverse para la terminal — evaluación, CI/CD, cron, scripts y agentes de codificación locales. Sin AWS. Sin FFmpeg. Sin infraestructura.

Configuración

1. Regístrate en botverse.cloud — prueba gratuita: $1 de crédito al registrarte, sin necesidad de tarjeta. Una tarjeta + 2FA solo se necesitan en tu primera recarga (mín. $5). Sin cuotas mensuales.
2. Obtén una clave de API o una URL de conector desde tu panel de control
3. Añádelo a la configuración de tu cliente MCP

Uso

Claude Desktop / Cursor / Windsurf

{
  "mcpServers": {
    "botverse": {
      "command": "npx",
      "args": ["-y", "botverse-mcp"],
      "env": {
        "BOTVERSE_API_KEY": "bv_live_..."
      }
    }
  }
}

O con una URL de conector (recomendado para claude.ai):

{
  "mcpServers": {
    "botverse": {
      "command": "npx",
      "args": ["-y", "botverse-mcp"],
      "env": {
        "BOTVERSE_CONNECTOR_URL": "https://botverse.cloud/mcp?token=bv_sess_..."
      }
    }
  }
}

Línea de comandos (botverse)

El mismo paquete incluye una CLI de botverse para la terminal — lee archivos del disco y los transmite directamente a la API (ningún contenido pasa por un LLM), por lo que es la vía rápida para evaluación, automatización y agentes de codificación locales.

export BOTVERSE_API_KEY=bv_live_…        # or BOTVERSE_CONNECTOR_URL=…?token=bv_sess_…

npx botverse convert report.md --to pdf
npx botverse convert *.md --to docx,pdf -o ./out
npx botverse transcode clip.mov --to mp4 -o ./out
npx botverse transcribe call.mp4 --to docx --attendees "Sarah Chen,Mike Torres"
npx botverse conform video.mp4 audio.wav --to mp4 --method speed_conform --target-framerate 25
npx botverse balance

Cada trabajo sube → consulta → descarga el archivo final a -o (por defecto: directorio actual). Los globs y múltiples formatos de --to se ejecutan como un lote.

Nota sobre entornos aislados: la CLI necesita red de salida hacia botverse.cloud y el host de almacenamiento de archivos de Botverse, por lo que no se ejecuta dentro de entornos de agente aislados (claude.ai / Claude Desktop), cuyo tráfico de salida está en lista blanca. En esos casos, usa las herramientas MCP (p. ej., convert_content) en su lugar.

Herramientas (MCP)

Herramienta	Descripción
get_upload_url	Obtén una URL prefirmada para subir un archivo para usar con las herramientas basadas en clave de objeto _media/_file/_video
transcode_from_url	Transcodifica video desde una URL pública
transcode_video	Transcodifica un archivo de video subido
conform_from_url	Combina una fuente de video + audio separadas (URLs públicas) en una sola salida
conform_media	Combina una fuente de video + audio subidas en una sola salida
conform_splice_from_url	Concatena segmentos de video/imagen (URLs públicas) — cabeceras, insertos, tarjetas finales, cortes, clips unidos
conform_splice_media	Concatena segmentos de video/imagen subidos — mismos casos de uso
convert_content	Convierte contenido de documento en línea (hasta 4 MB; seguro para entornos aislados)
convert_from_url	Convierte un documento desde una URL pública
convert_file	Convierte un documento subido
submit_workflow	Envía un flujo de trabajo BWDL de varios pasos que encadena varias de las herramientas anteriores, con ordenamiento de dependencias y ramas paralelas
get_workflow_status	Consulta un flujo de trabajo (y su estado por paso) hasta que alcance un estado terminal
cancel_workflow	Cancela un flujo de trabajo en curso; los pasos ya completados se facturan, el resto no
get_job_status	Consulta un trabajo hasta que se complete
get_download_url	Obtén la URL de descarga firmada
get_wallet_balance	Consulta el saldo de la billetera

Flujos de trabajo

submit_workflow encadena múltiples herramientas de Botverse (transcodificar, convertir, transcribir, conformar, empalmar) en un único trabajo del lado del servidor — p. ej., transcribir → extraer clips → entrega — en lugar de que tu agente haga cada llamada y consulte cada una individualmente.

• Las definiciones de flujo de trabajo usan BWDL (Lenguaje de Definición de Flujos de Trabajo de Botverse): un objeto JSON con un workflow_id y un array de steps. Cada paso tiene un id, un tool (cualquier nombre de herramienta MCP), un objeto inputs y un array opcional de depends_on con los ids de pasos anteriores.
• Los pasos se ejecutan en orden de dependencia; los pasos que comparten el mismo depends_on se ejecutan en paralelo.
• Un paso posterior puede referenciar la salida de un paso anterior con "$.steps.<step_id>.output_key", y un parámetro a nivel de flujo de trabajo con "$.params.<name>" — no se admite otra sintaxis de plantilla.
• Envía con submit_workflow, consulta con get_workflow_status cada 5–10 segundos hasta que el estado sea COMPLETED, FAILED, PARTIALLY_FAILED o CANCELLED, y detén antes con cancel_workflow si es necesario (solo se te facturan los pasos que ya se completaron).
• Facturación: los flujos de trabajo de solo conversión se cobran del saldo de la billetera a $0.05/paso. Los flujos de trabajo que contienen un paso de transcodificación o transcripción requieren que la recarga automática esté habilitada (la facturación escala según la duración de la fuente).

Ejemplo — una cadena de conversión de dos pasos (URL → DOCX → PDF):

{
  "workflow_id": "md-to-pdf-via-docx",
  "steps": [
    {
      "id": "to_docx",
      "tool": "convert_from_url",
      "inputs": {
        "source_url": "https://example.com/report.md",
        "output_format": "docx"
      }
    },
    {
      "id": "to_pdf",
      "tool": "convert_file",
      "depends_on": ["to_docx"],
      "inputs": {
        "object_key": "$.steps.to_docx.output_key",
        "output_format": "pdf"
      }
    }
  ]
}

Precios

• Transcodificación de video (≤5 min): $0.25/trabajo
• Exceso de video: +$0.08/min
• ProRes 422: $0.35/min de fuente (mín. $0.50)
• Conversión de documentos: $0.05/archivo

Los créditos nunca caducan. Precios completos →

Enlaces

• Documentación
• Panel de control
• Soporte