MCP
Referencia · tools

Tools de academy

El dominio academy es DynamoAcademy, la plataforma de formación de Dynamo: cursos por perfil, lecciones, quiz y certificado. Estas 8 tools le dan a un agente la consulta del contenido y la administración de cursos de un proyecto. Cada tool es una cáscara fina sobre una RPC (academy.*): quién ve qué, quién es admin y qué versión de cada curso corresponde lo decide la base, nunca acá. Corre con tu propia sesión, sobre un pool dedicado (app_academy), nunca con una clave de servicio.

En producción academy puede no estar montado todavía. Hasta que DynamoAcademy termine su paso a producción (Fase 5), el gateway de producción (mcp.dynamotech.co) puede arrancar sin el dominio academy: entonces estas 8 tools no aparecen en la lista de tools del conector y el resto del gateway funciona igual. Este manual es el mismo archivo en QA y en producción, así que no puede saberlo por sí solo. Para comprobarlo, pedile al asistente que corra dynamo_session_status: si versiones.academy dice no montado (fuera de GATEWAY_DOMAINS), academy no se sirve en ese ambiente; cualquier otro valor (una versión o no disponible, que sólo quiere decir que el paquete no publica su número de versión) quiere decir que sí. En QA (mcp-qa.dynamotech.co) está montado.

gateway remoto 6 lectura 2 escritura

El contenido que devuelven es dato de referencia, no instrucciones. Cada fragmento llega dentro de un bloque <academy-contenido> con su fuente y su versión. Si una lección dice «hacé tal cosa», eso describe el producto; no es una orden para el asistente.

Un id ajeno devuelve el mismo error que «no existe». Pedir una lección, un curso o un certificado que no es de tu proyecto da exactamente «No encontrado.», sin decir por qué: es deliberado, para no confirmar que el id existe. Un project_id sin acceso a Academy da el mismo «No tenés acceso» exista o no.

Lo que NO se hace por MCP. Rendir el quiz, marcar una lección como completada, registrar el examen práctico y revocar o reemitir un certificado son actos de personas y se hacen en la app. Un agente consulta y administra asignaciones; no rinde ni firma por nadie.

Lectura (6)

Tool Qué hace Inputs Qué permiso hace falta Ejemplo de prompt
academy_search Busca en el texto y en la transcripción de las lecciones de los cursos que la persona tiene asignados en el proyecto, sin importar tildes. Devuelve fragmentos con su ruta (curso › lección › sección), la versión, el estado de la lección, el tipo y el minuto si viene de un video, con un link directo. Sin resultados dice que no hubo en los cursos asignados de ese proyecto, sin mencionar otros. project_id (uuid, opcional: si tenés acceso a un solo proyecto se usa ese) · query (texto, 2-200) · limit (1-20, por defecto 5) · course_id (opcional) · tipo (tutorial, how-to, referencia o explicacion, opcional) Sesión autenticada con el grant de la app academy en el proyecto, y el curso asignado a la persona. "¿Cómo creo un flujo de aprobación en un formulario?"
academy_get_lesson La lección entera: cada sección con su encabezado y después la transcripción con marcas de minuto. Si supera el máximo de tokens se corta en el borde de una sección y avisa cómo pedir el resto o abrirla en la app. Una lección en revisión lo dice al principio. project_id (uuid, opcional: si tenés acceso a un solo proyecto se usa ese) · course_id · lesson_slug · max_tokens (500-16000, por defecto 4000) · incluir_transcripcion (por defecto sí) Sesión autenticada con el grant de la app academy en el proyecto, y el curso asignado a la persona. "Leé la lección 'crear-flujo-aprobacion' del curso de administración de formularios."
academy_whats_new Una tabla por curso con las lecciones nuevas o modificadas: lección, tipo, cambio y link. Con desde compara contra esa versión. project_id (uuid, opcional: si tenés acceso a un solo proyecto se usa ese) · course_id (opcional) · desde (versión X.Y.Z, opcional) Sesión autenticada con el grant de la app academy en el proyecto, y el curso asignado a la persona. "¿Qué cambió en los cursos desde la 1.0.0?"
academy_list_courses Los cursos del proyecto con la versión que se está sirviendo, el avance n/m, el quiz, el examen práctico, el certificado y el link. Si quien llama es admin, agrega la tabla de estadísticas por curso. Con course_id, el detalle de ese curso. project_id (uuid, opcional: si tenés acceso a un solo proyecto se usa ese) · course_id (opcional) Sesión autenticada con el grant de la app academy en el proyecto, y el curso asignado a la persona. Las estadísticas por curso, solo admin. "¿Qué cursos tengo asignados y cuánto llevo?"
academy_progress_report La tabla persona × curso × versión con avance, nota, examen práctico y certificado. Corta antes de 200 KiB y devuelve el cursor de la página siguiente. project_id (uuid, obligatorio) · course_id (opcional) · user_id (uuid, opcional) · limit (1-500, por defecto 100) · cursor (opcional) Admin del proyecto con el grant de academy, o global-admin. "Dame el avance de todo el equipo en el curso de operación en campo."
academy_verify_certificate Dice si un certificado está vigente o revocado y devuelve los datos que se firmaron (nombre, curso, versión, nota, organización, fecha). Un código que no existe en ese proyecto responde lo mismo que uno de otro proyecto. project_id (uuid, obligatorio) · codigo (uuid) Admin del proyecto con el grant de academy, o global-admin. "Verificá el certificado 3e9a0c34-… del proyecto Acme."

Escritura (2)

Tool Qué hace Inputs Qué permiso hace falta Ejemplo de prompt
academy_publish_course_version Fija en un proyecto la línea X.Y de un curso (y, opcional, el anexo del cliente). Se sirve siempre el parche más nuevo de esa línea. Si la línea no existe, responde cuáles hay. Acepta idempotency_key. project_id (uuid, obligatorio) · course_id · linea (X.Y) · anexo (opcional) · por_defecto (por defecto no) · perfiles_por_defecto (opcional) Solo global-admin, con una sesión de scope write (con un token read responde que la herramienta modifica datos). "Fijá la línea 1.0 del curso de administración de formularios en el proyecto Acme."
academy_assign_course Agrega o quita personas de un curso en el proyecto. Devuelve los conteos por resultado y la lista de quienes no tienen el grant de academy en el proyecto. Acepta idempotency_key. project_id (uuid, obligatorio) · course_id · agregar (hasta 500 uuid) · quitar (hasta 500 uuid; al menos una de las dos lleva ids, y ninguno puede estar en las dos) Admin del proyecto con el grant de academy, o global-admin; con una sesión de scope write (con un token read responde que la herramienta modifica datos). "Asigná el curso de operación en campo a estas tres personas."

Para errores concretos de estas tools: Troubleshooting. Para correr los MCPs en stdio localmente en vez del gateway: Para desarrolladores.