dutic-mcp
MCP server that gives AI agents read access to the DUTIC (UNSA Moodle) virtual classroom — tasks (including hidden ones), grades, materials, people and session management.
Tasks & deadlines: list upcoming or all tasks (including hidden ones not shown in the calendar), per-course tasks, and full assignment detail (instructions, attachments, dates,
dateConflictwarnings, submission status, grades).Courses: list enrolled courses, get sections/modules, teachers, and downloadable resources.
Materials: list course files (expanded folders, filterable by section), download individual files, bulk-download course files, read resources as Markdown (PDF→text), and convert local PDFs to Markdown.
Grades: view grade summary across all courses or per-item detail; read official SISACAD partial grades and compare them against Moodle's totals.
People: list all course participants (with optional email), search a person by name/email across courses, view any user's profile by ID (including teachers and role), and get course teachers.
Change tracking: check what's new since the last review (new tasks, grades, submissions, date changes).
Exploration: fetch any classroom page by URL in text/HTML/links format for cases not covered by other tools.
Session & identity: see your own profile, check session status/expiry, and attempt silent session renewal.
Notably, it cannot automate SISACAD login or solve CAPTCHAs, and it accesses only data the user can already see in Moodle.
Allows interaction with the DUTIC (Moodle) virtual classroom of UNSA, providing tools to list tasks (including hidden ones), courses, and resources, and to download files from courses.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@dutic-mcp show me my upcoming tasks"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
dutic-mcp
Servidor MCP + CLI para el aula virtual DUTIC (Moodle) de la UNSA. Tus tareas —incluidas las ocultas—, notas, materiales de estudio y compañeros, en la terminal y disponibles para agentes de IA (Claude Code, Antigravity, OpenCode, mimocode, GitHub copilt, warpin etc).
┌─────────────────────────────────────────────┐
│ 24 tareas · 10 SIN ENTREGAR │
│ 18 ocultas que el calendario no te muestra │
└─────────────────────────────────────────────┘Por qué existe
El timeline de Moodle sólo muestra tareas accionables (futuras y sin entregar). Las tareas sin
fecha de calendario, ya vencidas o ya entregadas desaparecen de la vista — y así se pierden
entregas. dutic barre todos los cursos, encuentra esas tareas, las marca como OCULTA y ordena
lo pendiente por urgencia.
Related MCP server: Campus
Instalación
Requisitos: Node.js ≥ 20 y Google Chrome (o Edge) instalado. No hace falta descargar Chromium: se usa el navegador que ya tienes.
Un solo comando
npm install -g @josetra/dutic-mcpEsto deja dutic y dutic-mcp en tu PATH.
git clone https://github.com/JOSETRA44/dutic-mcp.git
cd dutic-mcp
npm install # compila automáticamente (script prepare)
npm install -g . # deja los comandos en el PATHPrimeros pasos
1. Configura tus agentes (una vez)
dutic setupRegistra el servidor MCP en los agentes que tengas instalados y copia la skill dutic a sus
directorios. Hace copia de seguridad (*.dutic-bak) y no toca el resto de tu configuración.
[OK] Claude Code (MCP) C:\Users\tu-usuario\.claude.json
[OK] Antigravity (MCP) ...\.antigravity\config\mcp_config.json
[OK] OpenCode (MCP) ...\.config\opencode\opencode.jsonc
[OK] mimocode (MCP) ...\.config\mimocode\mimocode.jsonc
[OK] Claude Code (skill) ...\.claude\skills\duticReinicia cada agente para que cargue el servidor.
2. Inicia sesión (una vez)
dutic loginSe abre tu Chrome en el aula virtual. Pulsa «Ingresar con Correo UNSA», elige tu cuenta de Google y espera: la ventana se cierra sola al capturar la sesión. El perfil del navegador queda guardado, así que las renovaciones posteriores suelen ser automáticas.
3. Compruébalo
dutic status # ¿sesión válida?
dutic tasks --all # tus tareas, incluidas las ocultasSi ves tus tareas, ya está todo listo. Pídeselo también a tu agente: «¿tengo alguna tarea pendiente en el aula virtual?»
3. Comandos Rapidos (Cheat Sheet)
Una vez iniciada la sesion, usa estos comandos frecuentemente para interactuar con tu entorno:
# Ver estado de sesion
dutic status
# Revisar que tareas faltan (incluyendo ocultas)
dutic tasks --all
# Descargar materiales del curso a tu computadora
dutic study <courseId> --dest ./materiales
# Forzar busqueda de nuevos cursos matriculados
dutic courses --refreshUso — CLI
Comando | Qué hace |
| Tareas próximas del timeline (rápido) |
| + barrido de cursos → incluye las ocultas |
| Sólo las ocultas |
| Novedades desde la última revisión (tareas/notas nuevas, entregas, fechas) |
| Tu propio perfil (nombre, correo, id) |
| Captura tus notas parciales de SISACAD — tú haces el login + CAPTCHA; sólo tus datos |
| Muestra las notas ya capturadas, agrupadas por curso con promedio ponderado |
| Compara el promedio de SISACAD (oficial) con el total que calcula Moodle |
| Biblioteca Virtual UNSA: libros con sede, signatura y ejemplares ( |
| Ficha de un libro: temas y cada ejemplar con su estado (disponible/prestado) y vencimiento |
| Detalle: consigna, fechas, adjuntos, conflicto de fechas |
| Notas: resumen de todos los cursos, o detalle de uno |
| Cursos matriculados |
| Archivos del curso, por unidad |
| Baja materiales y convierte PDFs a Markdown |
| Lee un recurso (PDF→Markdown) para analizarlo |
| Convierte un PDF local a Markdown |
| Todos los compañeros del curso, con correo ( |
| Busca por nombre/correo: su correo y sus cursos reales (con grupo), marcando cuáles compartes |
| Perfil por id (docentes incluidos): correo, rol, cursos — resuelve el curso en común solo, sin |
| Docentes del curso |
| Busca cursos o docentes en la base de datos local |
| Explora cualquier página del aula por URL (cambiar ids, ver lo que no tiene botón) |
| Descarga todos los materiales |
| Revisión automática en segundo plano (tarea programada, sin daemon) |
| Gestiona la caché local (perfiles, cursos…) |
| Configuración y sesión |
Opciones globales: --refresh (ignora la caché y trae datos frescos), --no-cache, --json.
Rendimiento y Refresco
Las consultas de personas/cursos se cachean en disco (~/.dutic/cache/): repetir person,
people, grades o tasks es casi instantaneo. Usa --refresh para ignorar el cache temporalmente y forzar datos frescos. Esto es muy util para reescanear tras algun cambio (matriculas nuevas, fechas extendidas, etc.).
Ejemplos Utiles
# Que me falta entregar exactamente?
dutic tasks --all
# Forzar que busque nuevas tareas saltandose el cache
dutic tasks --all --refresh
# Preparar solo la unidad que voy a estudiar
dutic study 2279 --section "Tema 2" --dest ./materiales
# Que pide exactamente esta tarea?
dutic task 385686
# Forzar el rescanneo de materiales de un curso
dutic materials 2279 --refresh
# Quien es y en que cursos coincido con el? (correo + todos los cursos compartidos)
dutic person "Piero"
Uso — con agentes (MCP)
Tras dutic setup no hay nada más que hacer: pregúntale a tu agente por tus tareas, notas o
materiales y usará las herramientas del servidor.
{
"mcpServers": {
"dutic": {
"command": "dutic-mcp"
}
}
}El semestre no se configura aquí: vive en ~/.dutic/semesters.json y el servidor lo lee en
cada llamada, así que dutic semester use surte efecto sin reiniciar el agente.
Si tu cliente no resuelve comandos del PATH, usa la ruta absoluta que imprime dutic setup:
{ "command": "node", "args": ["<ruta>/dist/mcp/server.js"] }
41 herramientas: biblioteca (dutic_library_search, dutic_library_record), semestres (dutic_semester_list, dutic_semester_use,
dutic_semester_current, dutic_semester_discover), novedades (dutic_check_changes), notas SISACAD (dutic_get_sisacad_grades,
dutic_compare_grades), perfil propio (dutic_whoami), tareas
(dutic_list_tasks, dutic_get_assignment_detail, …), notas
(dutic_get_grades), materiales (dutic_list_course_materials, dutic_study_course,
dutic_read_resource, dutic_pdf_to_markdown), personas (dutic_list_participants,
dutic_find_person, dutic_get_person_profile, dutic_get_course_teachers), presencia en vivo
(dutic_online_users), catálogo institucional (dutic_list_schools, dutic_school_courses),
Dashboard (dutic_dashboard_blocks, dutic_dashboard_add_block, dutic_dashboard_remove_block),
exploración por URL (dutic_fetch_page) y sesión.
Encuesta de desempeño docente
Cada semestre toca llenar la encuesta de evaluación docente en el extranet
(extranet.unsa.edu.pe/encuesta2): 21 preguntas por cada profesor. Con 7 docentes son ~147
clics en un formulario de hace quince años. Esto lo reduce a una frase.
dutic encuesta login # usuario + clave (la de matrícula)
dutic encuesta policy set --escala Siempre --calificacion 18 # tu criterio, una sola vez
dutic encuesta fill --todas # SIMULA: enseña las 21 respuestas
dutic encuesta fill --todas --enviar --si-es-irreversible # envía de verdadCon matices por docente o por pregunta:
dutic encuesta policy set --docente QUENAYA --escala "A veces" --calificacion 12
dutic encuesta show BEJAR --escala Siempre --pregunta 4=Nunca # puntualidad aparteEl envío es irreversible y sólo se puede hacer una vez por docente. Por eso:
Todo simula por defecto; enviar exige
--enviary--si-es-irreversible.No hay respuesta por defecto escondida en el código: sin política configurada, la herramienta se niega a completar en vez de inventarse una valoración.
Antes de cada POST se vuelve a comprobar que el id de alternativa que va a viajar corresponde a la etiqueta que se te mostró. En este sistema los ids van al revés que la escala (
731=Nunca…728=Siempre, la mejor respuesta tiene el id más bajo), así que todo se resuelve por la etiqueta de texto y nunca por posición.Nunca se reenvía algo ya llenado: se comprueba contra el servidor y contra un registro local (
~/.dutic/encuesta-log.json), que es la única prueba de lo enviado porque el sistema no da acuse.
Desde un agente: dutic_encuesta_preview para revisar y dutic_encuesta_submit para una evaluación
real docente por docente, o dutic_encuesta_fill_all para el modo zero touch con tu política.
Biblioteca Virtual UNSA
Busca en el catálogo Koha de bibliotecavirtual.unsa.edu.pe:8081 sin sesión: es público.
dutic lib search matematica para economistas # título, autor, año, sede, signatura y nº de ejemplares
dutic lib search --por autor chiang -n 50 # por autor, 50 resultados en UNA petición
dutic lib search --por isbn 978-958-778-162-5 # ISBN con o sin guiones
dutic lib search econometria --fichas 5 # además precarga 5 fichas (~0.3 s c/u)
dutic lib show 823127 # ficha: temas y cada ejemplar con su estadoPara el operador del piloto existe además dutic lib harvest, que copia el catálogo completo
(199 270 registros) al esquema library de Supabase en tandas reanudables. Corre solo en
GitHub Actions (tanda nocturna + refresco incremental diario, ver
.github/workflows/library-harvest.yml) y no se usa en un equipo normal: requiere
DUTIC_LIBRARY_INGEST_TOKEN, un token acotado que sólo puede escribir bibliografía.
El portal tarda ~10 s en cada consulta nueva. La causa y cómo la mitigamos están en
docs/biblioteca-diagnostico.md: caché en dos niveles, ráfagas
secuenciales por la conexión caliente y precarga de fichas. Una búsqueda repetida (aunque cambien
las tildes) sale de caché al instante. --refresh fuerza la consulta y dutic lib cache-clear
borra la caché (~/.dutic/biblioteca/cache).
Piloto de notificaciones por WhatsApp (opt-in)
Experimento separado del uso personal de arriba: un bot que avisa por WhatsApp cuando aparece una tarea o nota nueva. Sólo para quien decida enrolarse explícitamente — nadie queda inscrito sin haberlo pedido.
dutic saas enroll # te registra (una vez) y te da un código corto de 6 caracteres
# le escribes ese código, tal cual, al número de WhatsApp del bot (te lo da el operador del piloto)Y ya está — no hay nada más que recordar. dutic saas enroll deja activada la revisión
automática: tu PC revisa el aula virtual sola cada 3 horas y te avisa por WhatsApp si aparece una
tarea o una nota. Puedes verlo con dutic auto status y desactivarlo con dutic auto uninstall.
Cómo está construido, y por qué:
El scraping nunca sale de tu PC.
dutic saas pushreutiliza el mismodutic watchde siempre; sólo empuja el resultado (tarea nueva, nota nueva) a Supabase — jamás tuMoodleSessionni tusesskey. Centralizar el login de Google OAuth de otros estudiantes en la nube no es viable (los sistemas anti-bot de Google bloquean ese patrón) ni seguro (expondría la sesión de todos en un solo lugar), así que el login sigue pasando, como siempre, en la máquina de cada quien.La mensajería usa Baileys (librería no oficial de WhatsApp) con 1-3 números dedicados/externos del piloto — nunca el número personal de un estudiante. Sólo esos números del bot están expuestos a un eventual baneo de Meta; son reemplazables sin afectar a nadie más. El envío tiene demoras aleatorias entre mensajes y variación de texto para reducir el riesgo de detección como spam.
"Despertador" del bot: el dispatcher normalmente sólo corre por cron (2x/día), así que un código de vinculación enviado justo después de
dutic saas enrollpodía quedar con el check gris horas. La Edge Functionenrolldispara unworkflow_dispatchde GitHub Actions apenas se crea un estudiante nuevo, con una ventana de escucha más larga (150s) que la de las corridas por cron (20s). Comoenrolles un endpoint público, el disparo está limitado a uno cada 2 minutos (tabladispatch_wakeups, claim atómico) sin importar cuántas veces se llame — así no se puede agotar el presupuesto gratis de Actions ni el rate-limit del token de GitHub llamandoenrollen bucle.Sin daemon residente. La revisión automática no deja ningún proceso vivo consumiendo RAM: se registra una tarea en el Programador de tareas de Windows que ejecuta
dutic auto runcada 3 h; cada pasada dura segundos y termina. En reposo el consumo es cero. Se usa el Programador de tareas y no una claveRundel registro precisamente porque esa clave es el patrón de persistencia que marcan los antivirus.Respetuoso con tu laptop y con la UNSA. Corre en prioridad baja, sólo si hay red, nunca despierta un equipo dormido, y se salta la pasada si no hay conexión o si estás usando
dutica mano. El disparo lleva retraso aleatorio (hasta 45 min) para que, si muchos estudiantes lo tienen instalado, no barran el aula virtual todos en el mismo instante.Nunca aparece una ventana de la nada. La renovación de sesión en segundo plano es estrictamente headless. Si el SSO de Google caduca de verdad y no se puede renovar en silencio, en vez de abrirte un navegador sin avisar, el bot te escribe por WhatsApp pidiéndote que corras
dutic login.Piloto con consentimiento explícito de cada participante — no un lanzamiento masivo a la facultad.
Configuración
Variable | Para qué | Por defecto |
| Fija el semestre desde el entorno ( | auto |
| Navegador para el login: |
|
| Dónde guardar sesión y perfil |
|
| Usuario de la encuesta docente (evita guardarlo en disco) | — |
| Clave de la encuesta docente | — |
Varios semestres a la vez
Cada período académico es un Moodle independiente (/2025B/, /2026A/…) con su propia sesión,
sus cursos y sus notas. dutic los mantiene aislados en ~/.dutic/semesters/<ID>/, así que
cambiar de ciclo no pierde nada del anterior.
dutic semester discover # sondea el aula: qué períodos existen
dutic semester list # cuáles conoces, cuál está activo, cuál tiene sesión
dutic semester use 2025B # cambiar el activo (persistente)
dutic semester use 2025B --login # …y entrar de una vez
dutic tasks --all -s 2026A # consulta puntual sin cambiar el activo
dutic semester auto # volver a la selección automática (por fecha)
dutic semester forget 2024B --purge --yes # archivar un ciclo y liberar su espacioEl semestre se resuelve por precedencia: --semester → DUTIC_SEMESTER → activo guardado →
sesión existente → deducido de la fecha. dutic semester current te dice cuál se aplicó y por qué.
Al actualizar desde una versión anterior, el estado plano de ~/.dutic/ se migra solo al
directorio del semestre que declara la sesión guardada; no hay que hacer nada.
Presencia, Escuelas y bloques del Dashboard
El aula publica más de lo que enseña su interfaz. Tres cosas que dutic ahora sabe leer
(el detalle técnico, con lo medido y lo que no se puede hacer, está en
docs/hallazgos-aula.md):
# Quién está conectado ahora mismo (precisión de segundos)
dutic online
dutic online "carpio" # ¿está conectada esta persona?
# Cursos y docentes de CUALQUIER Escuela, sin estar matriculado
dutic escuela list # las ~46 Escuelas del semestre
dutic escuela cursos "sistemas" # sus cursos, con grupo y profesor
dutic escuela cursos economia --por-docente
# El Dashboard es una composición de bloques: lo que no está puesto, no llega
dutic dashboard list --disponibles
dutic dashboard add online_usersDos advertencias que el propio servidor impone:
El bloque de presencia da el total del sitio pero sólo nombra a quien comparte curso contigo, y corta en 50. Que alguien no aparezca no prueba que esté desconectado.
dashboard add/removemodifican tu cuenta en el aula: el cambio se ve también desde el navegador.
Cómo funciona
No usa la API pública de web services (la UNSA la tiene bloqueada). Captura la cookie
MoodleSession y el token sesskey tras el login de Google (Playwright manejando tu Chrome) y con
ellos llama al endpoint AJAX interno de Moodle, complementado con scraping donde hace falta.
Necesidad | Fuente | Estado |
Descubrir todas las tareas |
| SI |
Cursos matriculados |
| SI |
Timeline y fechas |
| SI (sólo accionables) |
Estado de entrega, consigna, adjuntos | scraping de | SI |
Notas | scraping de | SI |
Personas y correos | scraping de | SI |
| — | NO bloqueadas por la UNSA |
Fechas contradictorias: algunas consignas mencionan una fecha distinta a la configurada en
Moodle. dutic task <cmid> compara ambas y avisa (dateConflict) — es la causa típica de entregas
perdidas.
SISACAD es distinto a propósito. Es un sistema aparte (extranet.unsa.edu.pe) protegido con
CAPTCHA, y esa protección se respeta: dutic sisacad no automatiza el login ni resuelve el CAPTCHA
por ti — abre el navegador, tú entras con tu usuario/clave y lo resuelves, y sólo cuando aparecen
tus notas la herramienta las lee y las estructura (por curso, con el promedio ponderado). Nunca
accede a datos de otros estudiantes.
Publicar en npm
npm login # cuenta de npm
npm version patch # o minor / major
npm publish # el paquete es scoped y público (publishConfig.access)
git push --follow-tagsprepublishOnly compila antes de publicar y files limita el tarball a dist/ y skills/.
Si tu scope de npm no es
@joswetra, cambia el camponameenpackage.jsonpor@tu-scope/dutic-mcp(o un nombre sin scope que esté libre).
Privacidad y seguridad
La sesión (
~/.dutic/session.json) y el perfil del navegador contienen credenciales de tu cuenta: no se versionan y el archivo se crea con permisos restrictivos.El certificado de
aulavirtual.unsa.edu.pe(CA privada de la UNSA) se acepta sólo para ese host.La herramienta accede únicamente a lo que tú ya ves en el aula. Donde Moodle oculta información (docentes en el listado, compañeros de otros grupos) se respeta esa restricción.
dutic profile <userId>resuelve un id a la vez, dado por una vía legítima tuya (una tarea calificada, un correo, un enlace que ya tenías). No está pensado ni se debe usar para recorrer rangos de ids y construir un directorio de docentes/estudiantes de la facultad — eso sería scraping masivo de datos personales de terceros sin su consentimiento.El piloto de notificaciones (
dutic saas enroll/push) es opt-in: sólo guarda datos de quien ejecutaenrollexplícitamente.pending_notificationsystudentsen Supabase existen sólo para avisar al propio dueño de esa fila — nunca para leer, listar o reenviar datos de otro estudiante.
Telemetría
dutic envía telemetría técnica para detectar y corregir fallos. La primera vez que la usas te lo
avisa, y puedes ver exactamente qué hace con dutic telemetry status.
Se envía | No se envía nunca |
Nombre del comando o herramienta MCP, duración y resultado | Tu |
Clase del error y su mensaje saneado (sin rutas personales, tokens ni datos personales) | Argumentos y resultados de las herramientas |
Versión de dutic, sistema operativo, arquitectura, versión de Node, zona horaria | Tus notas, tareas, cursos o archivos |
Aula y semestre del evento (p.ej. | El nombre de tu equipo o de tu usuario del sistema |
Identidad, sólo si aceptas. Tras
dutic loginse te pregunta una vez si quieres asociar tu nombre y correo institucional; sin ese "sí", tu cuenta es un seudónimo (HMAC) imposible de revertir desde nuestra base. Cámbialo cuando quieras condutic telemetry identity on|off.Si entras al piloto, quedas identificado.
dutic saas enrollasocia tu nombre y correo institucional a la telemetría y te lo dice al hacerlo: para avisarte por WhatsApp ya compartes esos datos, y sin identidad no podríamos ayudarte cuando algo te falle. Se revierte condutic telemetry identity off.Sin sorpresas en segundo plano. Los eventos se guardan en
~/.dutic/telemetry/y se envían en lotes con un tiempo máximo corto; sin red, esperan. Nunca bloquean ni retrasan un comando.Apagarla:
dutic telemetry off, o las variablesDUTIC_TELEMETRY=0oDO_NOT_TRACK=1. En CI está apagada.Borrar lo enviado:
dutic telemetry forgetelimina del servidor todo lo enviado desde tu equipo (derecho de cancelación, Ley N.º 29733) y apaga la telemetría.
Licencia
MIT © JOSETRA44
Available Tools
24 toolsdutic_check_changesNovedades desde la última revisiónA
Compara el estado académico actual con la última vez que se revisó y devuelve QUÉ cambió: tareas nuevas (incl. ocultas), notas recién publicadas o modificadas, cambios de estado de entrega y de fecha. Actualiza la línea base salvo que save sea false. Ideal para responder '¿hay algo nuevo?' o para un chequeo periódico. Usa datos frescos (ignora la caché).
Inputs: save.
dutic_compare_gradesComparar notas SISACAD vs. MoodleA
Compara el promedio ponderado de SISACAD (oficial) con el total que calcula Moodle, curso por curso (usando el nombre normalizado, sin confundir 'II' con 'III'). Útil para detectar si el aula virtual y el sistema oficial de notas están desincronizados. Requiere haber capturado antes con dutic sisacad; si no hay datos, avisa al usuario.
Inputs: no named parameters.
dutic_download_fileDescargar un archivoA
Descarga un archivo del aula virtual a una ruta local. Acepta la URL de vista del módulo o directamente una URL de pluginfile.php.
Inputs: url (required), destPath (required).
dutic_fetch_pageExplorar cualquier página del aula por URLA
Descarga CUALQUIER página del aula virtual con la sesión activa y devuelve su contenido. Pensada para explorar Moodle 'jugando con las URLs' — cambiar ids, ver páginas a las que no llegas por un botón: perfiles (user/view.php?id=N), cursos, foros, calificadores, etc. format: 'text' (texto legible), 'html' (crudo, para inspeccionar), 'links' (sólo enlaces internos, para descubrir a dónde navegar). Restringida al host del aula. Úsala cuando el usuario quiera investigar algo que las otras herramientas no cubren, o para descubrir ids.
Inputs: url (required), format, maxChars.
dutic_find_personBuscar una persona por nombre o correoA
Busca a una persona entre los participantes de TODOS los cursos del usuario, por nombre o por correo. Abre su perfil y devuelve su correo, su acceso MÁS RECIENTE (lastAccess + lastSeenAgoSeconds; se toma el más reciente entre todos los cursos, no el más antiguo) y TODOS sus cursos reales (course id + grupo, GA = Grupo A). Cada curso trae shared: true/false según si TÚ llevas exactamente ese curso (mismo course id — nunca confunde tu sección con la suya) y, si lo compartes, su lastAccess a ese curso. sharedCount = cuántos comparten. Úsalo para '¿quién es X?', '¿qué cursos lleva X?', '¿cuándo se conectó X?' o buscar por correo.
Inputs: query (required).
dutic_get_assignment_detailDetalle completo de una tareaA
Devuelve TODO lo de una tarea: la consigna/instrucciones completas, los archivos adjuntos a la consigna (guías, rúbricas — puedes leerlos con dutic_read_resource), fechas oficiales de apertura y cierre, estado de entrega, nota y quién calificó. IMPORTANTE: incluye dateConflict y datesInDescription — los docentes a veces escriben en el texto una fecha distinta a la configurada en Moodle; si dateConflict es true, AVISA al usuario de la discrepancia. Úsalo cuando el usuario pregunte qué pide una tarea o cuándo se entrega.
Inputs: cmid (required).
dutic_get_course_contentsContenido de un cursoC
Devuelve las secciones y módulos (tareas, recursos, foros...) de un curso.
Inputs: courseId (required).
dutic_get_course_tasksTareas de un cursoC
Lista las tareas de un curso concreto, incluidas las ocultas (hidden=true).
Inputs: courseId (required).
dutic_get_course_teachersDocentes de un cursoA
Identifica a los docentes del curso combinando los contactos del curso, los roles del listado y —lo que suele funcionar en esta aula— el nombre de quien calificó las tareas. Úsalo cuando el usuario pregunte quién es su profesor de un curso.
Inputs: courseId (required).
dutic_get_gradesVer calificacionesA
Devuelve las calificaciones del usuario. Sin courseId: resumen de TODOS los cursos (nota total + cuántos ítems quedan por calificar). Con courseId: detalle por ítem (nota, rango, porcentaje, peso). Úsalo cuando el usuario pregunte por sus notas, promedio, o cómo va en un curso.
Inputs: courseId.
dutic_get_person_profilePerfil de una persona (por id)A
Perfil de CUALQUIER usuario por su userId (sirve también para DOCENTES): nombre, correo, ROL ('Estudiante'/'Profesor' — así confirmas si es docente), zona horaria y TODOS sus cursos reales con course id y grupo. Sin courseId, prueba automáticamente tus propios cursos hasta encontrar uno que la persona también curse/dicte — no hace falta que el usuario lo busque a mano. Puede recibir un array de userIds (máx. 50) para resolver múltiples perfiles en lote.
Inputs: userId (required), courseId.
dutic_get_sisacad_gradesNotas de SISACAD (parciales oficiales)A
Devuelve las notas parciales OFICIALES de SISACAD que el usuario capturó con dutic sisacad (sistema aparte del aula, protegido con CAPTCHA; el usuario hace su propio login). Cada curso trae sus ítems (parcial, nota 0-20, peso %, ausente) y el weightedAverageSoFar (promedio ponderado con lo ya calificado). Sólo lee lo ya guardado — no abre navegador ni accede a datos de terceros. Si no hay datos, indícale al usuario que ejecute dutic sisacad en una terminal.
Inputs: no named parameters.
dutic_list_course_filesRecursos descargables de un cursoB
Lista los archivos/recursos descargables de un curso (con su URL de descarga).
Inputs: courseId (required).
dutic_list_course_materialsListar materiales de un curso (carpetas expandidas)A
Lista TODOS los archivos descargables de un curso, expandiendo las carpetas a sus archivos reales (diapositivas, lecturas, prácticas…). Devuelve nombre, URL, sección (unidad) y carpeta. Úsalo para saber qué materiales hay, y por qué unidad, antes de leer o descargar. Con section filtras a una unidad concreta.
Inputs: courseId (required), section.
dutic_list_coursesListar cursos DUTICA
Lista los cursos en los que estás matriculado (id, nombre, docentes).
Inputs: no named parameters.
dutic_list_participantsParticipantes de un cursoA
Lista TODOS los participantes de un curso recorriendo la paginación (nombre, rol, grupo, último acceso y, con withEmail, su correo institucional). Si el curso usa grupos separados, Moodle sólo muestra a los del grupo del usuario — es lo mismo que ve en la web. Úsalo para saber quiénes son sus compañeros o de qué grupo es alguien.
Inputs: courseId (required), withEmail.
dutic_list_tasksListar tareas DUTICB
Lista tus tareas del aula virtual. scope='upcoming' usa el calendario (rápido). scope='all' barre TODOS los cursos para incluir tareas ocultas que no aparecen en el calendario (marcadas con hidden=true) — útil para no perder entregas.
Inputs: scope, detailed, onlyHidden.
dutic_pdf_to_markdownConvertir un PDF local a MarkdownA
Convierte un PDF que ya está en disco a Markdown/texto para analizarlo sin gastar tokens en el binario. Opcionalmente guarda el resultado en outPath. No requiere sesión de Moodle.
Inputs: filePath (required), outPath, maxChars.
dutic_pull_course_filesDescargar todos los recursos de un cursoB
Descarga en bloque todos los archivos/recursos de un curso a un directorio local. Devuelve la lista de archivos guardados con su tamaño.
Inputs: destDir (required), courseId (required), section.
dutic_read_resourceLeer un recurso como texto/MarkdownA
Descarga un recurso del aula (PDF, texto…) y devuelve su CONTENIDO como Markdown listo para analizar, SIN gastar tokens en el binario. Convierte PDFs a texto automáticamente. Úsalo cuando el usuario quiera que analices, resumas o extraigas algo de un material del curso (sílabo, informe, guía, lectura). Para binarios no soportados (docx, imágenes) avisa y sugiere descargar. Acepta la URL de vista del módulo o de pluginfile.php.
Inputs: url (required), maxChars.
dutic_refresh_sessionRenovar sesión DUTICA
Intenta renovar la sesión sin interacción (si el SSO de Google sigue vivo). Si falla, hay que ejecutar dutic login en una terminal.
Inputs: no named parameters.
dutic_session_statusEstado de sesión DUTICA
Indica si hay una sesión válida, el semestre y cuándo caduca.
Inputs: no named parameters.
dutic_study_coursePreparar materiales de un curso para estudiarA
Descarga todos los materiales de un curso a un directorio y CONVIERTE los PDFs a Markdown (.md) organizados por carpeta, para estudiar/analizar offline sin gastar tokens en binarios. Devuelve el manifiesto de lo guardado. Úsalo cuando el usuario quiera 'preparar/bajar el material para estudiar' de un curso. Con section bajas sólo esa unidad — útil para no descargar todo de golpe cuando el usuario quiere estudiar una unidad concreta.
Inputs: destDir (required), courseId (required), section.
dutic_whoamiMi propio perfilA
Devuelve el perfil del propio usuario: nombre, correo institucional e id.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 24 tools
Most tools have clearly distinct purposes, but there is some overlap: dutic_list_tasks and dutic_get_course_tasks, dutic_list_course_files and dutic_list_course_materials, and dutic_read_resource vs dutic_pdf_to_markdown. Descriptions help clarify, but a few similar operations could cause confusion.
All tools use a consistent 'dutic_' prefix and generally follow a verb_noun snake_case pattern. A few exceptions like 'dutic_session_status' (noun_noun) and 'dutic_whoami' (non-standard) break the pattern, but overall the naming is predictable.
With 24 tools, the set is on the higher side but still reasonable for a comprehensive academic assistant covering grades, tasks, courses, files, and user information. Each tool serves a specific function, and the number aligns with the breadth of features.
The tool set covers most common student needs: grade retrieval, task management, course exploration, file download, user lookup, and session handling. Minor gaps exist (e.g., no assignment submission or forum interaction), but the core workflows are well-supported.
Maintenance
Related MCP Connectors
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
MCP server for the Inistate platform: module discovery, entry management, and activity submission.
Read-only MCP server for ClassQuill, a tutoring-business-management platform.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMCP server that turns UPB Virtual (Moodle) into a structured knowledge source, enabling AI assistants to query courses, assignments, deadlines, announcements, and sync materials via REST API.MIT
- AlicenseBqualityBmaintenanceUnofficial CLI to access UPC Aula Virtual (Blackboard) from the terminal, with an MCP server for Claude to manage courses, assignments, and downloads.56193 npm13ISC
- AlicenseNot gradedqualityDmaintenanceA powerful Model Context Protocol (MCP) server that seamlessly integrates AI assistants with Moodle Learning Management System. Enable your AI assistant to access courses, retrieve educational content, download resources, and search through your learning materials.22 npm1MIT
- FlicenseAqualityCmaintenanceMCP server for the Moodle-based Campus Virtual FCEIA UNR, providing tools to read courses, assignments, forums, and grades, plus write operations (posting, grading, messaging, events) with dry-run safety.201-