Para agentes de IA

Convertir vídeo con MCP

Muxara expone un servidor MCP remoto para que Claude, Cursor y otros agentes puedan crear trabajos de conversión, subir medios y descargar resultados.

Herramientas

Ocho herramientas MCP replican el flujo de conversión del sitio. Los agentes las invocan por Streamable HTTP en el endpoint siguiente.

list_conversions

Listar todas las opciones de conversión con extensiones de entrada aceptadas y formato de salida.

get_conversion_defaults

Obtener parámetros predeterminados y válidos de códec, calidad y recorte para un slug.

create_conversion_job

Crear un trabajo y recibir una URL de subida firmada (máx. 500 MB de entrada).

confirm_upload

Confirmar que el archivo se subió a la URL firmada.

update_conversion_job

Cambiar el formato de salida o la configuración de conversión antes del procesamiento.

start_conversion

Encolar la conversión FFmpeg en el worker.

get_conversion_status

Consultar el estado y progreso del trabajo cuando esté listo.

get_media_info

Analizar el archivo subido para duración, resolución, códecs y bitrate.

Casos de uso

Asistentes de chat con IA

Un usuario pide a su asistente convertir un MKV a MP4. El agente lista formatos, crea un trabajo, guía la subida y devuelve un enlace de descarga cuando esté listo.

Pipelines de automatización

Scripts o trabajos de CI crean conversiones, suben mediante URLs firmadas y consultan el estado sin navegador - útil para flujos de preparación de medios.

Descubrimiento de formatos

Los agentes llaman a list_conversions y get_conversion_defaults antes de elegir el slug adecuado para la extensión del archivo y el dispositivo destino.

Integraciones con editores y CMS

Crea herramientas personalizadas que delegan la transcodificación en Muxara manteniendo los mismos límites que el sitio público.

Flujo de trabajo

Los bytes del archivo no se envían mediante llamadas a herramientas MCP. La subida usa una URL firmada, igual que en el sitio web.

  1. create_conversion_job - devuelve jobId y uploadUrl
  2. PUT del archivo a uploadUrl (Content-Type: application/octet-stream)
  3. confirm_upload
  4. start_conversion (opcionalmente update_conversion_job antes)
  5. get_conversion_status hasta que el estado sea ready
  6. Descargar desde la URL en la respuesta de estado

Conectar

Usa transporte Streamable HTTP. El endpoint es https://api.muxara.com/mcp.

Cursor

Añade a tu configuración MCP (.cursor/mcp.json o ajustes de Cursor):

{
  "mcpServers": {
    "muxara": {
      "url": "https://api.muxara.com/mcp"
    }
  }
}

MCP Inspector

Ejecuta el inspector, elige Streamable HTTP e introduce la URL completa del endpoint:

npx @modelcontextprotocol/inspector
# Streamable HTTP → https://api.muxara.com/mcp

Autenticación

El servidor MCP es público - no se requieren claves API, OAuth ni cuenta de Muxara.

  • Sin clave API ni registro
  • Streamable HTTP en api.muxara.com/mcp
  • Se aplican límites de uso razonable
  • Conversión y descarga gratuitas

Preguntas frecuentes

No. El servidor MCP es público con límites de uso razonable, igual que el sitio. No se requiere OAuth ni cuenta.

No. create_conversion_job devuelve una uploadUrl firmada. PUT del archivo directamente a esa URL (hasta 500 MB), luego llama a confirm_upload. Igual que el subidor del navegador.

No. La conversión y descarga son gratuitas, igual que en muxara.com.