Moodle MCP (Aula USM)
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| AULA_URL | No | URL de tu Moodle | https://aula.usm.cl |
| AULA_TOKEN | Yes | Token de acceso a Moodle (lo escribe aula-mcp-login) | |
| AULA_DIR_BASE | No | Carpeta con una subcarpeta por ramo | |
| AULA_CONFIG_DIR | No | Dónde se guardan config.env y carpetas.json | ~/.config/aula-mcp |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Herramientas para consultar el Moodle del estudiante (por defecto, Aula USM).
ramoacepta el id numérico, el nombre corto, parte del nombre o la carpeta local vinculada.Empieza por listar_ramos si no sabes qué ramos hay.
Para el enunciado de una tarea usa ver_tarea: muchas lo traen solo como PDF adjunto, que se baja con descargar_material(ramo, recurso_id) o se lee con leer_material(ramo, recurso_id).
descargar_material guarda archivos en el computador del usuario: confirma con el usuario antes de usar todo=true.
Las notas y los correos son datos personales: muéstralos solo al usuario.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| listar_ramosA | Lista los ramos del estudiante (por defecto solo los vigentes), con su id y la carpeta local vinculada. |
| proximas_entregasA | Entregas y actividades pendientes con fecha límite en los próximos Con incluir_atrasadas también muestra las pendientes vencidas en las últimas 2 semanas.
|
| contenido_ramoC | Secciones y recursos de un ramo (id de recurso, tipo, nombre y archivos con su tamaño). |
| descargar_materialA | Descarga archivos de un ramo a su carpeta local, en /Aula/<sección>/. Filtra por recurso_id (de contenido_ramo) o por texto en |
| ver_tareaA | Detalle de una tarea: enunciado, archivos adjuntos del enunciado, fechas (apertura, vencimiento, corte), formato de entrega permitido y el estado de tu entrega (archivos enviados, nota y comentarios). tarea_id es el recurso_id que dan proximas_entregas o contenido_ramo. Muchas tareas traen el enunciado solo como PDF adjunto: bájalo con descargar_material(ramo, recurso_id=tarea_id). |
| leer_materialA | Lee el contenido de un archivo del ramo (PDF o texto) y además lo deja guardado en su carpeta local. Úsalo para entender un enunciado, una guía o un apunte. Identifica el archivo por recurso_id
(de contenido_ramo o ver_tarea) y, si el recurso tiene varios, por parte del nombre en |
| ver_notasA | Notas. Sin ramo: nota final de cada ramo. Con ramo: cada evaluación con nota, rango, % y comentarios. |
| avisos_y_forosB | Últimos avisos y discusiones de los foros de un ramo (los avisos primero). Usa foro_id para un solo foro. |
| leer_discusionA | Mensajes completos de una discusión de foro (discusion_id viene de avisos_y_foros). |
| contactos_ramoA | Profesores y ayudantes de un ramo, con su rol y correo (si Moodle lo deja visible). |
| vincular_carpetaA | Vincula un ramo con su carpeta local (ruta absoluta o relativa a AULA_DIR_BASE). Sin |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 11 tools
Each tool targets a distinct resource or action (courses, sections, files, assignments, grades, forums, contacts, folders, deadlines), and the descriptions explicitly chain ids between tools (recurso_id, tarea_id, discusion_id). The only real overlap is descargar_material vs leer_material, since both fetch a file and leer_material also saves it locally, but the descriptions clearly separate 'read content' from 'download to folder'.
All names are Spanish snake_case, which is consistent, but the verb convention is mixed: actions use ver_/leer_/descargar_/vincular_/listar_, while several retrieval tools are bare noun phrases (contenido_ramo, contactos_ramo, avisos_y_foros, proximas_entregas). Even within the 'list' category, listar_ramos takes a verb while proximas_entregas does not, so the pattern is readable but not predictable.
11 tools is well within the sweet spot and each one maps to a concrete Moodle workflow (browse courses, read content, download/read files, check assignments, grades, forums, contacts, link folders). Nothing appears redundant or padding the surface.
The read-side lifecycle is well covered: courses -> content -> files -> assignments -> grades -> forums -> contacts -> deadlines, with linking of local folders tying it together. The notable gap is write-side: ver_tarea reports the state of 'your submission' but there is no tool to submit an assignment or post a forum reply, which is a dead end for a core Moodle student action.