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 - con el mismo límite de 500 MB y límites de uso razonable que muxara.com.

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 los 82 slugs 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.

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

Conectar

Usa transporte Streamable HTTP. El endpoint canónico es https://api.muxara.com/mcp (alias: /sse).

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

Mismos límites que el sitio web

Las herramientas MCP usan la misma API de trabajos que muxara.com. Estos límites aplican a cada cliente.

Subida máx.	500 MB por archivo
Creación de trabajos	20 trabajos por hora (límite de uso razonable)
Solicitudes API	120 solicitudes por minuto (límite de uso razonable)
Retención de archivos	24 horas
Pares de conversión	82 slugs
Coste	Gratis: convierte y descarga sin coste (hasta 500 MB por archivo, aplican límites de uso razonable).

Documentación

Archivos de descubrimiento legibles por máquina y referencia completa para proveedores de LLM.

llms.txt
Índice del sitio curado para agentes LLM
llms-full.txt
Referencia completa con herramientas, API y guías de conversión
.well-known/mcp.json
Metadatos de descubrimiento del servidor MCP
.well-known/mcp/server-card.json
Lista de herramientas, límites y detalles del endpoint

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.

Sí. Ejecuta el worker de Muxara en el puerto 3001 y conéctate a http://localhost:3001/mcp con MCP Inspector o tu cliente.