Skip to main content
Glama
Moodle MCP (Aula USM)

Moodle MCP (Aula USM)

by muitomou

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
AULA_URLNoURL de tu Moodlehttps://aula.usm.cl
AULA_TOKENYesToken de acceso a Moodle (lo escribe aula-mcp-login)
AULA_DIR_BASENoCarpeta con una subcarpeta por ramo
AULA_CONFIG_DIRNoDó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).

  • ramo acepta 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

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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 dias días.

Con incluir_atrasadas también muestra las pendientes vencidas en las últimas 2 semanas. ramo filtra por un ramo.

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 buscar; todo=true baja todo el ramo. No sobrescribe archivos existentes salvo con sobrescribir=true. Si el ramo no tiene carpeta vinculada y no hay una única coincidencia, responde con candidatos para usar vincular_carpeta.

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 archivo. Devuelve hasta ~30 000 caracteres; para PDFs largos pide un rango con paginas='3-6'. No extrae imágenes ni fórmulas dibujadas: si hacen falta, abre el archivo de guardado_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 carpeta, solo sugiere carpetas candidatas. No crea carpetas.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A3.5/5.0

Scored across 11 tools

Disambiguation4/5

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'.

Naming Consistency3/5

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.

Tool Count5/5

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.

Completeness4/5

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.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues