Transloadit sobre MCP

Qué puede hacer tu agente

Al conectarse, obtiene siete herramientas, agrupadas en cuatro tareas:

• Descubrir qué es posible. transloadit_list_robots devuelve el catálogo con un resumen por Robot, y transloadit_get_robot_help devuelve los parámetros de uno de ellos. El agente no necesita haber sido entrenado con nuestra documentación para usarnos correctamente.
• Verificar el trabajo del agente antes de que cueste algo. transloadit_lint_assembly_instructions valida un conjunto de Assembly Instructions sin crear una Assembly, y devuelve mensajes estructurados en lugar de texto libre.
• Ejecutar el trabajo. transloadit_create_assembly crea o reanuda una Assembly, subiendo archivos y esperando el resultado si así se lo pides.
• Seguirlo hasta el final. transloadit_get_assembly_status y transloadit_wait_for_assembly hacen seguimiento de una Assembly en ejecución, y transloadit_list_templates reutiliza los Templates que ya tienes.

Puede explorar antes de poder gastar

El catálogo y el linter no requieren credenciales. Un agente puede listar todos los Robots, leer los parámetros de los que le interesan y validar un borrador, todo antes de que exista una cuenta. Pídele que pase el linter por un Step con un error y recibirá el error:

{
  "severity": "error",
  "path": "instructions",
  "message": "Path `steps.resized` has unrecognized keys: `widht`"
}

Cualquier operación que toque una cuenta es otro asunto. Listar tus Templates o crear una Assembly sin credenciales devuelve mcp_missing_auth, no una suposición ni un resultado parcial. Así, explorar es gratis, y gastar es deliberado.

Por qué esto es mejor que darle a un agente una clave de API

Un agente que apunta directo a una API REST tiene que conocer de antemano cómo está estructurada. Adivina el nombre de un parámetro, envía la solicitud y descubre que se equivocó una vez que el trabajo ya falló, lo que cuesta como mínimo una ida y vuelta y, en el peor de los casos, un cargo de encoding.

Las Assembly Instructions son JSON declarativo, que es justo el tipo de artefacto que un agente produce bien. Combinar eso con el descubrimiento y un linter cierra el ciclo antes de que se ejecute nada: puede preguntar qué existe, escribir los Steps, hacer que se verifiquen y solo entonces crear la Assembly. El procesamiento en sí ocurre en nuestra infraestructura, así que no hay que instalar FFmpeg ni llenar un disco local.

Conéctalo

El camino más rápido es el endpoint alojado:

https://api2.transloadit.com/mcp

Los clientes que buscan capacidades pueden leer la tarjeta del servidor, legible por máquina, en /.well-known/mcp/server-card.json⁠, que enumera las herramientas y sus esquemas de entrada.

Ejecutarlo tú mismo sobre stdio suele ser la mejor opción una vez que dejas atrás la fase de pruebas, porque entonces el proceso conserva tu TRANSLOADIT_KEY y tu TRANSLOADIT_SECRET y gestiona la autenticación por ti. La documentación del servidor MCP incluye ambas configuraciones, junto con los fragmentos de configuración del cliente.

Lo que no hará

• El servidor orquesta Transloadit. No ejecuta código arbitrario contra tus archivos, y no puede hacer nada que la API no pueda.
• El encoding se cobra como de costumbre. Un agente que reintenta en bucle una Assembly fallida gasta dinero real, así que dale un Workspace cuyos límites te resulten cómodos.
• Las herramientas cubren Assemblies, Robots y Templates. La administración de la cuenta, la facturación y las credenciales quedan deliberadamente fuera.
• No sustituye la lectura de la documentación de Robots cuando eres tú quien diseña el pipeline. Es a lo que recurres cuando es el agente quien lo hace.

Crea un Workspace gratuito para obtener las credenciales, o lee primero la documentación del servidor MCP.