Herramientas

moodle-mcp tiene 267 herramientas, 266 con el nivel de privacidad por defecto. Esta página se genera desde el propio servidor, así que las muestra tal y como las recibe tu aplicación de IA, con las descripciones que lee el agente, traducidas (el agente las recibe en inglés). Tú no llamas a las herramientas: pides las cosas con tus palabras y el agente las elige.

En las tablas, ✓ marca las herramientas que sigues teniendo con cada límite: Solo lectura con el acceso de solo lectura, Profesor y Alumno con cada rol. El acceso de solo lectura deja fuera todas las herramientas que cambian algo en Moodle (una nota, un mensaje, una actividad, un intento); las de sesión, como iniciar sesión o mostrar el navegador, siempre están, igual que download_file y export_grades, que solo guardan un fichero en tu ordenador.

Sesión

Herramienta	Descripción	Solo lectura	Profesor	Alumno
login	Iniciar sesión en Moodle	✓	✓	✓
logout	Cerrar sesión en Moodle	✓	✓	✓
get_me	Quién soy	✓	✓	✓
get_site_info	Obtener la información del sitio Moodle	✓	✓	✓
configure	Configurar el servidor	✓	✓	✓
show_browser	Mostrar u ocultar el navegador	✓	✓	✓
server_info	Información del servidor	✓	✓	✓
list_sites	Listar los sitios Moodle	✓	✓	✓
add_site	Añadir un sitio Moodle	✓	✓	✓
use_site	Cambiar a otro sitio Moodle	✓	✓	✓
remove_site	Quitar un sitio Moodle	✓	✓	✓

login

Iniciar sesión en Moodle

Se asegura de que haya una sesión de Moodle. Si la hay, devuelve al instante el usuario que ha iniciado sesión. Si no, abre una ventana del navegador en la página de inicio de sesión del sitio y espera a que la persona inicie sesión allí por sí misma (el servidor nunca ve su contraseña); después devuelve el usuario. Llámala cuando otra herramienta informe de una sesión ausente o caducada.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
timeoutSeconds		entero	Cuánto esperar a que la persona inicie sesión, en segundos (300 por defecto)

logout

Cerrar sesión en Moodle

Termina la sesión de Moodle de la persona en el navegador del servidor, para que otra persona pueda iniciar sesión (otra cuenta: login vuelve a abrir la ventana). Solo termina la sesión de Moodle: un proveedor de inicio de sesión único puede mantener la suya y volver a iniciar sesión con la misma persona. Solo cuando la persona lo pida.

Sin parámetros.

get_me

Quién soy

Indica quién es la persona que ha iniciado sesión: id de usuario, nombre de usuario, nombre completo, correo electrónico, idioma, zona horaria, primer y último acceso, y el sitio. Con courseId, también sus roles en ese curso y si puede editarlo y calificar en él.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId		entero	Un id de curso (de list_courses) para obtener también los roles y capacidades de la persona en él

get_site_info

Obtener la información del sitio Moodle

Lo que el sitio Moodle dice de sí mismo: su nombre, URL, idioma, cómo se inicia sesión (su propio formulario, acceso de invitados, proveedores de inicio de sesión único) y si está en mantenimiento; se puede leer antes de iniciar sesión. Con courseId, también los tipos de actividad y recurso que la persona puede añadir a ese curso (ninguno si no puede editarlo): toma de aquí el tipo para create_activity. Moodle solo muestra su versión a los administradores, así que no se da.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId		entero	Un curso para listar los tipos de actividad que se le pueden añadir

configure

Configurar el servidor

Establece la configuración de este servidor para esta sesión: el sitio Moodle (url; uno nuevo se añade a los sitios del servidor y se guarda, uno conocido pasa a ser el activo, consulta use_site), si el navegador se ejecuta sin ventana (headless), cómo ven y hacen las cosas las herramientas de estudiante (trail) y la carpeta del perfil del navegador (profileDir). También puede restringir los tipos de herramientas (scopes), el rol (role), el acceso a solo lectura (access) o los cursos en los que trabaja (courses) y endurecer cómo te llegan los datos de otras personas (studentData), nunca al revés: ampliarlos corresponde a la persona, en la configuración del cliente. Cada uno es opcional; solo cambian los indicados. Se comprueba que la URL sea un sitio Moodle. Se guarda solo en memoria, salvo un sitio nuevo, que se queda entre los sitios del servidor. Devuelve la configuración efectiva, como server_info.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
url		texto	La URL del sitio Moodle, o de cualquier página suya (vale la URL de un curso: el sitio se obtiene de ella)
headless		sí o no	Ejecutar el navegador sin ventana (iniciar sesión siempre muestra una)
trail		realistic, fast	Cómo ven y hacen las cosas las herramientas de estudiante: realistic (páginas reales, ritmo humano; Moodle registra las visualizaciones y la finalización) o fast
profileDir		texto	Carpeta absoluta del perfil del navegador que guarda la sesión de Moodle; fuera de la carpeta del servidor
scopes		texto	Restringir los tipos de herramientas para esta sesión: un perfil (teacher, student, content) o ámbitos (content, student-data, grading, communication, as-student, browser). Solo menos que ahora, nunca más
studentData		block, pseudonymize, clear	Endurecer cómo te llegan los datos de otras personas para esta sesión (block es el más estricto). Solo más estricto que ahora, nunca más laxo
role		all, teacher, student	Conservar solo las herramientas de un rol para esta sesión (teacher o student), a partir de all; nunca de vuelta a all
access		read, write	read: conservar solo las herramientas que no cambian nada en Moodle para esta sesión; nunca de vuelta a write
courses		lista de texto	Limita al agente a estos cursos durante esta sesión, por URL (…/course/view.php?id=N), en los sitios del servidor: entre las aulas que puso la persona, si las hay (ADR-025)

show_browser

Mostrar u ocultar el navegador

Muestra el navegador a la persona, para que pueda ver lo que hacen las herramientas: la ventana se abre ahora (la sesión se mantiene) y cada herramienta trae al frente la página de Moodle en la que trabaja. O lo oculta de nuevo: la ventana se cierra y las herramientas siguen sin ella. Solo cuando la persona pide verlo o dejar de verlo. Las pestañas abiertas no sobreviven al cambio; lo que se guardó en Moodle sí. No cambia nada en Moodle.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
visible	✅	sí o no	true para mostrar el navegador y seguir en él a las herramientas, false para ocultarlo

server_info

Información del servidor

Muestra la versión de este servidor y su configuración efectiva: el sitio Moodle activo y los demás, la carpeta del perfil del navegador, el navegador y de dónde viene cada ajuste. No contiene secretos. No abre el navegador.

Sin parámetros.

list_sites

Listar los sitios Moodle

Lista los sitios Moodle que conoce este servidor, por nombre: su URL, cuál es el activo (en el que trabajan todas las demás herramientas) y si cada uno viene de la configuración de la persona o se añadió durante el trabajo. Se cambia de sitio con use_site.

Sin parámetros.

add_site

Añadir un sitio Moodle

Añade un sitio Moodle a este servidor, que se guarda para las siguientes sesiones: su URL (vale cualquier página del sitio) y, opcionalmente, un nombre corto (letras, números, puntos y guiones; por defecto, su host). Sin url, se le preguntan ambos a la persona en su aplicación, cuando el cliente puede preguntarle (elicitación MCP); si no, pregúntaselos tú. Dos cuentas en un mismo sitio son dos sitios: añade la segunda con un nombre propio. No pasa a ser el activo: cambia a él con use_site, e inicia sesión allí cuando una herramienta lo pida. Solo cuando la persona pida otro sitio.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
url		texto	La URL del sitio, o cualquier página suya; sin ella, se le pregunta a la persona en su aplicación cuando se puede
name		texto	Un nombre corto para él; por defecto, su host

use_site

Cambiar a otro sitio Moodle

Hace activo otro sitio conocido, por su nombre (list_sites): desde ese momento todas las demás herramientas trabajan en él. El navegador del sitio anterior se cierra y conserva su sesión; si el nuevo no tiene sesión, la siguiente herramienta pedirá iniciarla. Dile a la persona en qué sitio trabajas ahora. Dura esta sesión.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
name	✅	texto	El nombre del sitio, tal como lo da list_sites

remove_site

Quitar un sitio Moodle

Olvida un sitio añadido durante el trabajo, por su nombre, y borra su perfil de navegador con su sesión. Ni el sitio activo (cambia antes de sitio) ni uno de la configuración de la persona (lo quita ella allí). No se puede deshacer: confírmalo antes con la persona. El servidor pide antes la confirmación de la persona en su aplicación (elicitation MCP); si dice que no, no pasa nada.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
name	✅	texto	El nombre del sitio, tal como lo da list_sites

Cursos y contenido

Herramienta	Descripción	Solo lectura	Profesor	Alumno
list_courses	Listar mis cursos	✓	✓	✓
get_course_structure	Obtener la estructura de un curso	✓	✓	✓
get_activity_content	Leer el contenido de una actividad	✓	✓	✓
get_activity_settings	Obtener los ajustes de una actividad	✓	✓
download_file	Descargar un archivo de Moodle	✓	✓	✓
create_activity	Crear una actividad o un recurso		✓
update_activity	Actualizar los ajustes o el contenido de una actividad		✓
validate_html	Comprobar HTML antes de enviarlo a Moodle	✓	✓	✓
edit_activity	Mover, renombrar, mostrar u ocultar una actividad		✓
duplicate_activity	Duplicar una actividad		✓
delete_activity	Eliminar una actividad		✓
add_section	Añadir una sección		✓
edit_section	Editar una sección		✓
delete_section	Eliminar una sección		✓
update_course	Actualizar la configuración de un curso		✓

list_courses

Listar mis cursos

Lista los cursos de Moodle en los que está matriculada la persona que ha iniciado sesión (como profesor o estudiante), con sus ids, nombres, categoría, URL, visibilidad, fechas y, donde Moodle lo registra, el progreso de la persona: solo como estudiante, en cursos con seguimiento de finalización (un profesor no obtiene ninguno; el progreso de los estudiantes está en get_completion_report). Filtra por fechas con classification.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
classification		all, inprogress, future, past	Qué cursos según sus fechas: "all" (por defecto), "inprogress", "future" o "past"

get_course_structure

Obtener la estructura de un curso

Obtiene las secciones y actividades de un curso de Moodle: ids, nombres, tipos, URL, visibilidad, si la persona puede abrir cada una, restricciones y, donde Moodle lo registra, la finalización de la persona: solo como estudiante, en actividades con seguimiento de finalización (un profesor no obtiene ninguna; la finalización de los estudiantes está en get_completion_report). Con details, también las fechas y el texto de restricción de cada actividad tal como los muestra la página del curso. Toma el id del curso de list_courses.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero	El id del curso, tal como lo da list_courses
details		sí o no	Leer también la página del curso para obtener las fechas y el texto de restricción de cada actividad (más lento; false por defecto)

get_activity_content

Leer el contenido de una actividad

Lee una actividad de contenido como lo haría una persona, de modo que Moodle registra la visualización: el texto de una página o etiqueta, los capítulos de un libro, el destino de un recurso URL, o los archivos de un recurso archivo o de una carpeta (como enlaces). Toma el id y el tipo de get_course_structure. Con el trail realistic lee página a página al ritmo de un lector e informa del progreso.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
activityId	✅	entero	El id de la actividad (id del módulo del curso), tal como lo da get_course_structure
type	✅	page, book, label, url, resource, folder	El tipo de la actividad, tal como lo da get_course_structure

get_activity_settings

Obtener los ajustes de una actividad

Lee todos los ajustes de una actividad tal como los contiene su formulario de edición, sin cambiar nada: su módulo, nombre, descripción, cada campo con su nombre en el formulario, etiqueta, valor y opciones, los archivos de un recurso, carpeta o SCORM, y sus restricciones de acceso y finalización en los términos que acepta update_activity. Úsala antes de update_activity. Solo profesores. Toma el id de la actividad de get_course_structure.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
activityId	✅	entero	El id de la actividad (id del módulo del curso), tal como lo da get_course_structure

download_file

Descargar un archivo de Moodle

Guarda un archivo del sitio Moodle en una carpeta local, con la sesión de la persona: un archivo de un recurso o de una carpeta (get_activity_content), el archivo del enunciado de una tarea o un archivo entregado (get_assignment, get_submissions), un adjunto de un foro (get_discussion). Solo URL del host del sitio configurado (también sus contenidos multimedia: vídeos que sirve fuera de Moodle); los enlaces externos (YouTube…) son para otras herramientas. Nunca sobrescribe: a un nombre ya existente se le añade un número. Devuelve dónde se ha guardado.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
url	✅	texto	La URL del archivo en el sitio, tal como la dan las demás herramientas (…/pluginfile.php/…)
destDir	✅	texto	Carpeta local absoluta en la que guardar; se crea si no existe

create_activity

Crear una actividad o un recurso

Crea una actividad o un recurso de cualquier tipo (page, label, url, resource, folder, assign, quiz, forum…) al final de una sección, mediante el propio formulario de Moodle, oculto a los estudiantes por defecto. Los campos comunes tienen sus propias entradas, incluidas las restricciones de acceso y la finalización; cualquier otro ajuste va en settings por el nombre de su campo del formulario. files son rutas locales que se suben a un recurso de archivo o a una carpeta, el paquete de un SCORM (type scorm, el primer archivo) o el de una actividad H5P (type h5pactivity, un .h5p, que se despliega la primera vez que se abre; sus ajustes a nombrar: enabletracking 1 o 0, grademethod 1 la mejor nota, 2 la media, 3 el último o 4 el primer intento, grade[modgrade_point] la nota máxima; el paquete solo se reproduce si el sitio tiene su tipo de contenido H5P). Devuelve el id de la nueva actividad y la estructura del curso. Cambia el curso: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
sectionId	✅	entero	El id de la sección, tal como lo da get_course_structure
type	✅	texto	El nombre del módulo en Moodle: page, label, url, resource, folder, assign, quiz, forum, book…
name		texto	Obligatorio salvo para las etiquetas
files		lista de texto	Rutas locales absolutas: el archivo de un recurso de archivo (el primero es el principal), los archivos de una carpeta, el paquete de un SCORM (.zip), el de una actividad H5P (.h5p)
toolId		entero	type lti: la herramienta externa a partir de la que se crea, tal como la da list_external_tools (Moodle 5 solo crea actividades LTI a partir de una herramienta)
description		texto	La descripción (HTML), que se muestra en la página de la actividad
content		texto	El contenido de una página, o el texto de una etiqueta (HTML)
url		texto	El destino de un recurso URL
visibility		shown, hidden, stealth	"stealth": oculto en la página del curso pero disponible por enlace, donde el sitio lo permite
restrictions		objeto	Cuándo pueden abrirlo los estudiantes ({ conditions: [] } las quita)
completion		objeto	Cuándo cuenta como completado
embed		lista de texto	Archivos locales absolutos (imágenes…) que incrustar en el HTML, que nombra cada uno por su nombre de archivo: <img src="shot.png">
settings		objeto	Cualquier otro campo del formulario por su nombre en el formulario de actividad de Moodle, p. ej., {"duedate[enabled]": true, "duedate[day]": 12, "grade[modgrade_point]": 10}

update_activity

Actualizar los ajustes o el contenido de una actividad

Cambia una actividad existente mediante el propio formulario de Moodle: nombre, descripción, el contenido de una página o de una etiqueta, el destino de una URL, visibilidad, restricciones de acceso, finalización, los archivos de un recurso de archivo o de una carpeta (añadir, quitar por su ruta tal como los lista get_activity_settings, o sustituirlos todos), el paquete de un SCORM (sustituido en su sitio: la actividad conserva su id, sus ajustes y su elemento de calificación; los intentos se quedan en los SCO que el nuevo paquete conserva, por su identificador, y se van con los que quita), o cualquier otro ajuste por el nombre de su campo del formulario en settings. Solo cambia lo que se indica. Devuelve la estructura del curso, y un SCORM tal como lo lee get_scorm tras un paquete nuevo. Cambia el curso: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
activityId	✅	entero	El id de la actividad (id del módulo del curso), tal como lo da get_course_structure
name		texto
description		texto	La descripción (HTML), que se muestra en la página de la actividad
content		texto	El contenido de una página, o el texto de una etiqueta (HTML)
url		texto	El destino de un recurso URL
visibility		shown, hidden, stealth	"stealth": oculto en la página del curso pero disponible por enlace, donde el sitio lo permite
restrictions		objeto	Cuándo pueden abrirlo los estudiantes ({ conditions: [] } las quita)
completion		objeto	Cuándo cuenta como completado
embed		lista de texto	Archivos locales absolutos (imágenes…) que incrustar en el HTML, que nombra cada uno por su nombre de archivo: <img src="shot.png">
settings		objeto	Cualquier otro campo del formulario por su nombre en el formulario de actividad de Moodle, p. ej., {"duedate[enabled]": true, "duedate[day]": 12, "grade[modgrade_point]": 10}
files		objeto	Los archivos de un recurso de archivo o de una carpeta; sin cambios si falta
package		texto	El nuevo paquete de un SCORM: una ruta local absoluta a un .zip, que sustituye al actual en su sitio

validate_html

Comprobar HTML antes de enviarlo a Moodle

Comprueba el HTML de una página, una etiqueta, una descripción o un mensaje antes de enviarlo, sin Moodle y de forma aproximada: solo Moodle sabe exactamente qué conserva su limpieza. Informa, con sus líneas, de errores de análisis y etiquetas sin cerrar, de lo que quita la limpieza de Moodle (scripts, estilos, marcos, formularios, atributos de eventos como onclick, enlaces javascript:), de archivos que el HTML nombra y que no son URLs ni están en embed, y de archivos de embed que no existen o que el HTML no nombra. Da embed como se lo darías a la herramienta de contenido.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
text		texto	El HTML
file		texto	O una ruta local absoluta a un archivo HTML
embed		lista de texto	Los archivos locales que vas a incrustar, tal como los toman las herramientas de contenido

edit_activity

Mover, renombrar, mostrar u ocultar una actividad

Mueve una actividad a otra sección (al final) o antes de otra actividad, para reordenar un curso; la renombra; o establece su visibilidad ("shown", "hidden" o "stealth": oculta en la página del curso pero disponible por enlace). Solo cambia lo que se indica. Devuelve después la estructura del curso. Cambia el curso: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero	El id del curso, tal como lo da list_courses
activityId	✅	entero	El id de la actividad (id del módulo del curso), tal como lo da get_course_structure
name		texto
visibility		shown, hidden, stealth
sectionId		entero	Moverla al final de esta sección
beforeActivityId		entero	Moverla antes de esta actividad (en la sección de esa actividad)

duplicate_activity

Duplicar una actividad

Duplica una actividad justo a continuación de sí misma, con su configuración y su contenido (no los datos de los participantes). Devuelve el id de la copia y la estructura del curso. Cambia el curso: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero	El id del curso, tal como lo da list_courses
activityId	✅	entero	El id de la actividad (id del módulo del curso), tal como lo da get_course_structure

delete_activity

Eliminar una actividad

Elimina una actividad de un curso, con los datos de sus participantes (entregas, intentos, mensajes, calificaciones). Destructivo: confírmalo antes con la persona, nombrando la actividad. El servidor pide antes la confirmación de la persona en su aplicación (elicitation MCP); si dice que no, no pasa nada.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero	El id del curso, tal como lo da list_courses
activityId	✅	entero	El id de la actividad (id del módulo del curso), tal como lo da get_course_structure

add_section

Añadir una sección

Añade una sección a un curso, al final o después de una sección dada, opcionalmente con nombre y descripción. Devuelve su id y la estructura del curso. Cambia el curso: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero	El id del curso, tal como lo da list_courses
name		texto
summary		texto	Su descripción (HTML)
embed		lista de texto	Archivos locales absolutos (imágenes…) que incrustar en el HTML, que nombra cada uno por su nombre de archivo: <img src="shot.png">
afterSectionId		entero	Añadirla después de esta sección; al final si falta

edit_section

Editar una sección

Cambia una sección: renombrarla, describirla, mostrarla u ocultarla (con sus actividades), restringir el acceso a ella o moverla después de otra sección. Solo cambia lo que se indica. Devuelve la estructura del curso. Cambia el curso: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero	El id del curso, tal como lo da list_courses
sectionId	✅	entero	El id de una sección (no su número), tal como lo da get_course_structure
name		texto
visible		sí o no
summary		texto	Su descripción (HTML)
embed		lista de texto	Archivos locales absolutos (imágenes…) que incrustar en el HTML, que nombra cada uno por su nombre de archivo: <img src="shot.png">
restrictions		objeto	Cuándo pueden abrirla los estudiantes ({ conditions: [] } las elimina)
afterSectionId		entero	Moverla después de esta sección

delete_section

Eliminar una sección

Elimina una sección y todas las actividades que contiene, con los datos de sus participantes. Destructivo: confírmalo antes con la persona, diciendo qué actividades se eliminan con ella. El servidor pide antes la confirmación de la persona en su aplicación (elicitation MCP); si dice que no, no pasa nada.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero	El id del curso, tal como lo da list_courses
sectionId	✅	entero	El id de una sección (no su número), tal como lo da get_course_structure

update_course

Actualizar la configuración de un curso

Cambia el nombre completo, el nombre corto, el resumen (HTML) o cualquier otro ajuste de un curso por el nombre de su campo en el formulario de configuración del curso de Moodle (settings), a través de ese formulario. Solo cambia lo que se indica. Devuelve el curso tras el cambio. Cambia el curso: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
fullName		texto
shortName		texto
summary		texto	HTML
embed		lista de texto	Archivos locales absolutos (imágenes…) que incrustar en el HTML, que nombra cada uno por su nombre de archivo: <img src="shot.png">
settings		objeto	Otros campos por su nombre en el formulario de configuración del curso, p. ej. {"visible": 0, "startdate[day]": 1}

Libros, lecciones, wikis, glosarios, bases de datos y feedback

Herramienta	Descripción	Solo lectura	Profesor	Alumno
list_book_chapters	Listar los capítulos de un libro	✓	✓
add_book_chapter	Añadir un capítulo a un libro		✓
edit_book_chapter	Cambiar un capítulo de un libro		✓
move_book_chapter	Subir o bajar un capítulo de un libro		✓
set_book_chapter_visibility	Mostrar u ocultar un capítulo de un libro		✓
delete_book_chapter	Eliminar un capítulo de un libro		✓
get_lesson_pages	Leer las páginas de una lección como su profesor	✓	✓
add_lesson_page	Añadir una página a una lección		✓
edit_lesson_page	Cambiar una página de una lección		✓
move_lesson_page	Mover una página de una lección		✓
delete_lesson_page	Eliminar una página de una lección		✓
get_database_fields	Leer los campos de una base de datos	✓	✓
add_database_field	Añadir un campo a una base de datos		✓
edit_database_field	Cambiar un campo de una base de datos		✓
delete_database_field	Eliminar un campo de una base de datos		✓
get_database_templates	Leer las plantillas de una base de datos	✓	✓
set_database_template	Guardar una plantilla de una base de datos		✓
list_database_presets	Listar los preajustes de una base de datos	✓	✓
apply_database_preset	Dar un preajuste a una base de datos		✓
list_database_entries	Leer las entradas de una base de datos	✓	✓	✓
add_database_entry	Añadir una entrada a una base de datos		✓	✓
edit_database_entry	Cambiar una entrada de una base de datos		✓	✓
delete_database_entry	Eliminar una entrada de una base de datos		✓	✓
set_database_entry_approved	Aprobar una entrada de una base de datos		✓
export_database_entries	Exportar las entradas de una base de datos a CSV	✓	✓
import_database_entries	Importar entradas a una base de datos desde CSV		✓
list_glossary_entries	Leer las entradas de un glosario	✓	✓	✓
add_glossary_entry	Añadir una entrada a un glosario		✓	✓
edit_glossary_entry	Cambiar una entrada de un glosario		✓	✓
delete_glossary_entry	Eliminar una entrada de un glosario		✓	✓
set_glossary_entry_approved	Aprobar una entrada de un glosario		✓
list_glossary_categories	Listar las categorías de un glosario	✓	✓	✓
add_glossary_category	Añadir una categoría a un glosario		✓
export_glossary	Exportar las entradas de un glosario a un archivo	✓	✓
import_glossary	Importar entradas a un glosario		✓
list_wiki_pages	Listar las páginas de una wiki	✓	✓	✓
get_wiki_page	Leer una página de una wiki	✓	✓	✓
create_wiki_page	Crear una página en una wiki		✓	✓
edit_wiki_page	Editar una página de una wiki		✓	✓
get_feedback_items	Leer las preguntas de un feedback	✓	✓
add_feedback_item	Añadir una pregunta a un feedback		✓
edit_feedback_item	Cambiar una pregunta de un feedback		✓
move_feedback_item	Mover una pregunta de un feedback		✓
delete_feedback_item	Eliminar una pregunta de un feedback		✓
list_feedback_templates	Listar las plantillas de feedback	✓	✓
use_feedback_template	Usar una plantilla en un feedback		✓
save_feedback_template	Guardar un feedback como plantilla		✓
delete_feedback_template	Eliminar una plantilla de feedback		✓

list_book_chapters

Listar los capítulos de un libro

Lista los capítulos de un libro en orden: id, título, si cada uno es un subcapítulo o está oculto, y su posición; con content, también el HTML y las imágenes de cada capítulo (se lee una página por capítulo, y Moodle lo registra como una visita). Un profesor ve los capítulos ocultos; un estudiante, no. Los ids de capítulo son los que toman las demás herramientas del libro.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
bookId	✅	entero	El id del libro (id del módulo del curso), tal como lo da get_course_structure
content		sí o no	También el HTML y las imágenes de cada capítulo

add_book_chapter

Añadir un capítulo a un libro

Añade un capítulo a un libro mediante el formulario de capítulo de Moodle: su título y su contenido (HTML, con imágenes locales incrustadas), al final o después de otro capítulo, como subcapítulo del capítulo anterior si se pide, oculto si se pide (visible por defecto, como lo añade Moodle: ocúltalo si el libro es visible y el capítulo no está listo). Devuelve el id del nuevo capítulo y los capítulos. Cambia el curso: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
bookId	✅	entero	El id del libro (id del módulo del curso), tal como lo da get_course_structure
title	✅	texto
content	✅	texto	Su contenido (HTML); Moodle exige alguno
subchapter		sí o no	Un subcapítulo del capítulo anterior (no para el primero)
hidden		sí o no	Oculto a los estudiantes
afterChapterId		entero	El capítulo tras el que va; al final si falta
embed		lista de texto	Archivos locales absolutos (imágenes…) que incrustar en el contenido, que nombra cada uno por su nombre de archivo: <img src="shot.png">

edit_book_chapter

Cambiar un capítulo de un libro

Cambia el título, el contenido (HTML, con imágenes locales incrustadas) o si es un subcapítulo, mediante su formulario: solo cambia lo que se indica. move_book_chapter lo mueve y set_book_chapter_visibility lo muestra u oculta. Devuelve después los capítulos. Cambia el curso: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
bookId	✅	entero	El id del libro (id del módulo del curso), tal como lo da get_course_structure
chapterId	✅	entero	El id del capítulo, tal como lo da list_book_chapters
title		texto
content		texto
subchapter		sí o no
embed		lista de texto	Archivos locales absolutos (imágenes…) que incrustar en el contenido, que nombra cada uno por su nombre de archivo: <img src="shot.png">

move_book_chapter

Subir o bajar un capítulo de un libro

Mueve un capítulo un puesto arriba o abajo, como las flechas de la tabla de contenidos: un capítulo se mueve con sus subcapítulos, saltando el capítulo entero anterior o siguiente; un subcapítulo se mueve solo. Vuelve a llamarla para moverlo más. Devuelve después los capítulos. Cambia el curso: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
bookId	✅	entero	El id del libro (id del módulo del curso), tal como lo da get_course_structure
chapterId	✅	entero	El id del capítulo, tal como lo da list_book_chapters
direction	✅	up, down

set_book_chapter_visibility

Mostrar u ocultar un capítulo de un libro

Muestra un capítulo a los estudiantes o se lo oculta, como el ojo de la tabla de contenidos: los subcapítulos de un capítulo van con él, y un subcapítulo de un capítulo oculto sigue oculto. Devuelve después los capítulos. Cambia lo que ven los estudiantes: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
bookId	✅	entero	El id del libro (id del módulo del curso), tal como lo da get_course_structure
chapterId	✅	entero	El id del capítulo, tal como lo da list_book_chapters
visible	✅	sí o no

delete_book_chapter

Eliminar un capítulo de un libro

Elimina un capítulo con sus archivos; eliminar un capítulo (no un subcapítulo) elimina también sus subcapítulos. Devuelve después los capítulos. No se puede deshacer: confírmalo antes con la persona. El servidor pide antes la confirmación de la persona en su aplicación (elicitation MCP); si dice que no, no pasa nada.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
bookId	✅	entero	El id del libro (id del módulo del curso), tal como lo da get_course_structure
chapterId	✅	entero	El id del capítulo, tal como lo da list_book_chapters

get_lesson_pages

Leer las páginas de una lección como su profesor

Lee las páginas de una lección tal como las tiene su profesor en el editor de lecciones de Moodle, en orden: tipo (contenido, un tipo de pregunta, grupo, fin de grupo, fin de rama), título, contenido, y los botones de una página de contenido o las respuestas de una pregunta con sus retroalimentaciones, puntuaciones y saltos (el id de una página, o next-page, end-of-lesson…). Requiere el rol de profesor; un estudiante recorre una lección con get_lesson_page.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
lessonId	✅	entero	El id de la lección (id del módulo del curso), tal como lo da get_course_structure

add_lesson_page

Añadir una página a una lección

Añade una página a una lección mediante el editor de lecciones de Moodle: una página de contenido con sus botones, una página de pregunta (multichoice, truefalse, shortanswer, numerical, matching, essay) con sus respuestas, retroalimentaciones, puntuaciones y saltos, o un grupo, un fin de grupo o un fin de rama; tras una página, o al final. Un salto a una página que la lección no tiene se rechaza antes de guardar nada, así que añade primero las páginas y pon después sus saltos con edit_lesson_page cuando apunten hacia delante. Devuelve el id de la nueva página y los ids de las páginas de la lección en orden. Cambia el curso: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
lessonId	✅	entero	El id de la lección (id del módulo del curso), tal como lo da get_course_structure
type	✅	content, multichoice, truefalse, shortanswer, numerical, matching, essay, cluster, end-of-cluster, end-of-branch
title		texto
contents		texto	El contenido de la página (HTML); los archivos locales que nombra (<img src="shot.png">) van en embed
embed		lista de texto	Archivos locales absolutos que incrustar en el contenido, las respuestas o las retroalimentaciones
buttons		lista de objeto	Los botones de una página de contenido, en orden; si se dan, sustituyen a todos
answers		lista de objeto	Las respuestas de una página de pregunta, en orden (si se dan, sustituyen a todas); la única fila de un ensayo o de una página estructural
multipleAnswers		sí o no	Opción múltiple: puede haber más de una respuesta correcta
caseSensitive		sí o no	Respuesta corta: las respuestas se comparan distinguiendo mayúsculas
fields		objeto	Cualquier otro campo del formulario de la página, por nombre (layout, display…)
after		entero	La página tras la que va (0: la primera); al final si falta

edit_lesson_page

Cambiar una página de una lección

Cambia una página de una lección mediante su formulario en el editor de lecciones: título, contenido, botones o respuestas (si se dan, sustituyen a todos), opciones y otros campos; solo cambia lo que se indica, y una página conserva su tipo. Un salto a una página que la lección no tiene se rechaza antes de guardar nada. Cambia el curso: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
lessonId	✅	entero	El id de la lección (id del módulo del curso), tal como lo da get_course_structure
pageId	✅	entero	El id de la página, tal como lo da get_lesson_pages
title		texto
contents		texto	El contenido de la página (HTML); los archivos locales que nombra (<img src="shot.png">) van en embed
embed		lista de texto	Archivos locales absolutos que incrustar en el contenido, las respuestas o las retroalimentaciones
buttons		lista de objeto	Los botones de una página de contenido, en orden; si se dan, sustituyen a todos
answers		lista de objeto	Las respuestas de una página de pregunta, en orden (si se dan, sustituyen a todas); la única fila de un ensayo o de una página estructural
multipleAnswers		sí o no	Opción múltiple: puede haber más de una respuesta correcta
caseSensitive		sí o no	Respuesta corta: las respuestas se comparan distinguiendo mayúsculas
fields		objeto	Cualquier otro campo del formulario de la página, por nombre (layout, display…)

move_lesson_page

Mover una página de una lección

Mueve una página de una lección tras otra (0: la primera), como el enlace de mover del editor de lecciones. Los saltos por id de página siguen llevando a las mismas páginas; next-page y previous-page siguen el nuevo orden. Devuelve los ids de las páginas en orden. Cambia el curso: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
lessonId	✅	entero	El id de la lección (id del módulo del curso), tal como lo da get_course_structure
pageId	✅	entero	El id de la página, tal como lo da get_lesson_pages
after	✅	entero	La página tras la que va (0: la primera)

delete_lesson_page

Eliminar una página de una lección

Elimina una página de una lección. Las respuestas de otras páginas que saltaban a ella quedan como las deja Moodle: revísalas con get_lesson_pages. Devuelve los ids de las páginas que quedan, en orden. No se puede deshacer: confírmalo antes con la persona. El servidor pide antes la confirmación de la persona en su aplicación (elicitation MCP); si dice que no, no pasa nada.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
lessonId	✅	entero	El id de la lección (id del módulo del curso), tal como lo da get_course_structure
pageId	✅	entero	El id de la página, tal como lo da get_lesson_pages

get_database_fields

Leer los campos de una base de datos

Lee los campos de una actividad de base de datos en orden: el id de cada uno, su nombre (las plantillas lo nombran [[nombre]]), su tipo, su descripción, si una entrada lo necesita y los ajustes de su tipo (opciones, tamaños…). Requiere el rol de profesor con permiso de edición.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
databaseId	✅	entero	El id de la base de datos (id del módulo del curso), tal como lo da get_course_structure

add_database_field

Añadir un campo a una base de datos

Añade un campo a una actividad de base de datos mediante el formulario de Moodle para su tipo: text, textarea, number, date, menu, radiobutton, checkbox, multimenu, url, file, picture o latlong, con un nombre único en la base de datos, una descripción, si es obligatorio (no para una fecha) y los ajustes del tipo. Las plantillas por defecto de Moodle lo muestran; a una plantilla guardada puede que haya que añadírselo (set_database_template). Devuelve su id y los campos. Cambia el curso: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
databaseId	✅	entero	El id de la base de datos (id del módulo del curso), tal como lo da get_course_structure
type	✅	text, textarea, number, date, menu, radiobutton, checkbox, multimenu, url, file, picture, latlong
name	✅	texto
description		texto
required		sí o no
options		objeto	Los ajustes del tipo; cada tipo admite solo los suyos

edit_database_field

Cambiar un campo de una base de datos

Cambia el nombre, la descripción, si es obligatorio o los ajustes de su tipo (uno a uno) de un campo de una base de datos: lo que falta se queda como está. Renombrarlo renombra su etiqueta en las plantillas, como hace Moodle. Su tipo no puede cambiar: elimínalo y añade otro. Devuelve los campos. Cambia el curso: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
databaseId	✅	entero	El id de la base de datos (id del módulo del curso), tal como lo da get_course_structure
fieldId	✅	entero	El id del campo, tal como lo da get_database_fields
name		texto
description		texto
required		sí o no
options		objeto	Los ajustes del tipo; cada tipo admite solo los suyos

delete_database_field

Eliminar un campo de una base de datos

Elimina un campo de una base de datos: lo que cada entrada tiene en él se va también, y sus etiquetas salen de las plantillas. Devuelve los campos. No se puede deshacer: confírmalo antes con la persona. El servidor pide antes la confirmación de la persona en su aplicación (elicitation MCP); si dice que no, no pasa nada.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
databaseId	✅	entero	El id de la base de datos (id del módulo del curso), tal como lo da get_course_structure
fieldId	✅	entero	El id del campo, tal como lo da get_database_fields

get_database_templates

Leer las plantillas de una base de datos

Lee las plantillas de una actividad de base de datos (list, listHeader, listFooter, single, add, search, rss, rssTitle, css, js): lo que se guardó, o lo predeterminado de Moodle para sus campos. Los campos aparecen como [[nombre]] y las demás etiquetas de Moodle como ##etiqueta##. Se rechaza mientras la base de datos no tenga campos (Moodle aún no tiene plantillas). Requiere el rol de profesor con permiso de edición.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
databaseId	✅	entero	El id de la base de datos (id del módulo del curso), tal como lo da get_course_structure

set_database_template

Guardar una plantilla de una base de datos

Guarda una de las plantillas de una base de datos tal como se da, sin el editor HTML de Moodle de por medio: list (repetida por entrada, entre listHeader y listFooter), single, add (el formulario de entrada: la etiqueta de cada campo una vez), search, rss, rssTitle, css o js. Los campos van como [[nombre]] y las demás etiquetas de Moodle como ##etiqueta## (##edit##, ##delete##, ##more##, ##user##…). reset: true vuelve a lo predeterminado de Moodle. Devuelve todas las plantillas. Cambia el curso: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
databaseId	✅	entero	El id de la base de datos (id del módulo del curso), tal como lo da get_course_structure
template	✅	list, listHeader, listFooter, single, add, search, rss, rssTitle, css, js
html		texto	La plantilla (HTML, o CSS o JavaScript)
reset		sí o no	Lo predeterminado de Moodle en su lugar (la cabecera y el pie de la lista se quedan)

list_database_presets

Listar los preajustes de una base de datos

Lista los preajustes que se pueden dar a una actividad de base de datos: los propios de Moodle (galería de imágenes, diario, propuestas, recursos) y los guardados en el sitio que la persona puede ver, cada uno con el id que toma apply_database_preset.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
databaseId	✅	entero	El id de la base de datos (id del módulo del curso), tal como lo da get_course_structure

apply_database_preset

Dar un preajuste a una base de datos

Da un preajuste a una actividad de base de datos, como «Usar este preajuste» de Moodle: se añaden sus campos, un campo con el mismo nombre y tipo se conserva con lo que tienen las entradas, todos los demás campos se eliminan con su contenido, y sus plantillas sustituyen a las de la base de datos. Devuelve los campos. Puede borrar contenido de las entradas: confírmalo antes con la persona. El servidor pide antes la confirmación de la persona en su aplicación (elicitation MCP); si dice que no, no pasa nada.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
databaseId	✅	entero	El id de la base de datos (id del módulo del curso), tal como lo da get_course_structure
presetId	✅	texto	Tal como lo da list_database_presets

list_database_entries

Leer las entradas de una base de datos

Lee las entradas de una actividad de base de datos en el orden de su lista: autor (un alias cuando el servidor seudonimiza), cuándo se añadió y cambió, si está aprobada, y el valor de cada campo en las entradas que la persona puede editar (todas para un profesor; las suyas para un estudiante). search es la búsqueda simple de Moodle. Una página cada vez: limit entradas (25 por defecto) tras saltar offset; more dice si hay más.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
databaseId	✅	entero	El id de la base de datos (id del módulo del curso), tal como lo da get_course_structure
search		texto
limit		entero	Cuántas entradas (25 por defecto, hasta 100)
offset		entero	Cuántas entradas saltar antes (0 por defecto)

add_database_entry

Añadir una entrada a una base de datos

Añade una entrada a una actividad de base de datos como la persona, con su formulario «Añadir entrada»: un valor por campo, por id o nombre (get_database_fields los nombra), archivos locales para los campos de archivo e imagen; los campos que faltan se quedan como los tiene el formulario (una fecha empieza en hoy). Devuelve el id de la entrada. Otros del curso pueden leerla: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
databaseId	✅	entero	El id de la base de datos (id del módulo del curso), tal como lo da get_course_structure
values	✅	objeto	Por id o nombre de campo: texto o un número; "AAAA-MM-DD" para una fecha; las opciones para casillas o una lista de selección múltiple; [latitud, longitud]; la ruta local absoluta de un archivo para un campo de archivo o imagen. Sin alias.

edit_database_entry

Cambiar una entrada de una base de datos

Cambia una entrada de una base de datos con su formulario de edición: los campos dados (archivos incluidos), el resto como están; removeFiles quita el archivo de un campo de archivo o imagen. Un estudiante cambia las suyas mientras Moodle le deja; un profesor, las de cualquiera. Confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
databaseId	✅	entero	El id de la base de datos (id del módulo del curso), tal como lo da get_course_structure
entryId	✅	entero	El id de la entrada, tal como lo da list_database_entries
values		objeto	Por id o nombre de campo: texto o un número; "AAAA-MM-DD" para una fecha; las opciones para casillas o una lista de selección múltiple; [latitud, longitud]; la ruta local absoluta de un archivo para un campo de archivo o imagen. Sin alias.
removeFiles		lista de texto	Campos de archivo o imagen (por id o nombre) cuyo archivo quitar

delete_database_entry

Eliminar una entrada de una base de datos

Elimina una entrada de una base de datos con sus valores y archivos. Un estudiante elimina las suyas mientras Moodle le deja cambiarlas; un profesor, las de cualquiera. No se puede deshacer: confírmalo antes con la persona. El servidor pide antes la confirmación de la persona en su aplicación (elicitation MCP); si dice que no, no pasa nada.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
databaseId	✅	entero	El id de la base de datos (id del módulo del curso), tal como lo da get_course_structure
entryId	✅	entero	El id de la entrada, tal como lo da list_database_entries

set_database_entry_approved

Aprobar una entrada de una base de datos

Aprueba una entrada de una base de datos que espera aprobación, o le quita la aprobación: una que espera solo la ven su autor y quien aprueba. Su autor lo ve: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
databaseId	✅	entero	El id de la base de datos (id del módulo del curso), tal como lo da get_course_structure
entryId	✅	entero	El id de la entrada, tal como lo da list_database_entries
approved	✅	sí o no

export_database_entries

Exportar las entradas de una base de datos a CSV

Guarda las entradas de una actividad de base de datos en un archivo CSV local, como su «Exportar entradas»: una columna por campo (sin imágenes ni archivos), con los datos de los autores, las fechas y la aprobación si se piden. Todas las entradas del grupo de la persona. El archivo contiene lo que escribieron los participantes tal cual: solo con los nombres visibles (el nivel de datos de estudiantes del servidor).

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
databaseId	✅	entero	El id de la base de datos (id del módulo del curso), tal como lo da get_course_structure
file	✅	texto	Una ruta local absoluta para el CSV (se sustituye si existe)
userDetails		sí o no	El nombre completo, el usuario y el correo de los autores
times		sí o no
approval		sí o no

import_database_entries

Importar entradas a una base de datos desde CSV

Añade entradas a una actividad de base de datos desde un archivo CSV local, como su «Importar entradas»: una fila de cabecera con los nombres de los campos (como la escribe export_database_entries; una columna Username hace autor a ese usuario), en UTF-8. Devuelve cuántas añadió Moodle. Cambia el curso: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
databaseId	✅	entero	El id de la base de datos (id del módulo del curso), tal como lo da get_course_structure
file	✅	texto	Una ruta local absoluta al CSV
delimiter		comma, semicolon, tab, colon

list_glossary_entries

Leer las entradas de un glosario

Lee las entradas de un glosario en su orden: concepto, definición (HTML), alias de búsqueda, categorías, autor (un alias cuando el servidor seudonimiza), si está aprobada y adjuntos. Lo que ve la persona: las entradas aprobadas y las suyas pendientes; pending da las que esperan aprobación, para un profesor. Por letra, o con una búsqueda en conceptos, alias y definiciones. Una página cada vez: limit entradas (30 por defecto) tras saltar offset; more dice si hay más.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
glossaryId	✅	entero	El id del glosario (id del módulo del curso), tal como lo da get_course_structure
letter		texto	Solo los conceptos que empiezan por esta letra
search		texto	Palabras en conceptos, alias o definiciones
pending		sí o no	Las entradas que esperan aprobación en su lugar (las de un profesor)
limit		entero	Cuántas entradas (30 por defecto, hasta 200)
offset		entero	Cuántas entradas saltar antes (0 por defecto)

add_glossary_entry

Añadir una entrada a un glosario

Añade una entrada a un glosario como la persona: su concepto, definición (HTML, con imágenes locales incrustadas), palabras clave, categorías y archivos locales adjuntos. La entrada de un estudiante espera la aprobación de un profesor donde el glosario lo pide. Devuelve la entrada. Otros del curso la leen: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
glossaryId	✅	entero	El id del glosario (id del módulo del curso), tal como lo da get_course_structure
concept	✅	texto
definition	✅	texto	HTML; sin alias
aliases		lista de texto	Otras palabras por las que se encuentra y se enlaza
categoryIds		lista de entero	Tal como las da list_glossary_categories
attachments		lista de texto	Rutas locales absolutas de archivos que adjuntar
embed		lista de texto	Archivos locales absolutos que incrustar en la definición, que nombra cada uno por su nombre de archivo: <img src="shot.png">

edit_glossary_entry

Cambiar una entrada de un glosario

Cambia una entrada de un glosario: solo lo que se indica (attachments sustituye sus archivos, [] los quita). Un estudiante cambia las suyas mientras dura el tiempo de edición del sitio; un profesor, las de cualquiera. Devuelve la entrada. Confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
glossaryId	✅	entero	El id del glosario (id del módulo del curso), tal como lo da get_course_structure
entryId	✅	entero	El id de la entrada, tal como lo da list_glossary_entries
concept		texto
definition		texto	HTML; sin alias
aliases		lista de texto	Otras palabras por las que se encuentra y se enlaza
categoryIds		lista de entero	Tal como las da list_glossary_categories
attachments		lista de texto	Rutas locales absolutas de archivos que adjuntar
embed		lista de texto	Archivos locales absolutos que incrustar en la definición, que nombra cada uno por su nombre de archivo: <img src="shot.png">

delete_glossary_entry

Eliminar una entrada de un glosario

Elimina una entrada de un glosario con sus archivos. Un estudiante elimina las suyas mientras dura el tiempo de edición del sitio; un profesor, las de cualquiera. No se puede deshacer: confírmalo antes con la persona. El servidor pide antes la confirmación de la persona en su aplicación (elicitation MCP); si dice que no, no pasa nada.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
glossaryId	✅	entero	El id del glosario (id del módulo del curso), tal como lo da get_course_structure
entryId	✅	entero	El id de la entrada, tal como lo da list_glossary_entries

set_glossary_entry_approved

Aprobar una entrada de un glosario

Aprueba una entrada que espera aprobación (list_glossary_entries con pending las lista), o le quita la aprobación: la entrada vuelve a esperar, oculta para todos salvo su autor y quien aprueba. Su autor lo ve: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
glossaryId	✅	entero	El id del glosario (id del módulo del curso), tal como lo da get_course_structure
entryId	✅	entero	El id de la entrada, tal como lo da list_glossary_entries
approved	✅	sí o no

list_glossary_categories

Listar las categorías de un glosario

Lista las categorías de un glosario, por id y nombre, que toman add_glossary_entry y edit_glossary_entry.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
glossaryId	✅	entero	El id del glosario (id del módulo del curso), tal como lo da get_course_structure

add_glossary_category

Añadir una categoría a un glosario

Añade una categoría a un glosario; con autoLink, Moodle enlaza su nombre allí donde aparezca en el curso. Devuelve su id y las categorías. Cambia el curso: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
glossaryId	✅	entero	El id del glosario (id del módulo del curso), tal como lo da get_course_structure
name	✅	texto
autoLink		sí o no

export_glossary

Exportar las entradas de un glosario a un archivo

Guarda las entradas aprobadas de un glosario en una carpeta local en el XML de Moodle (con alias de búsqueda, categorías y archivos), como su «Exportar entradas»; import_glossary las lleva a otro glosario. El archivo contiene lo que escribieron los participantes tal cual: solo con los nombres visibles (el nivel de datos de estudiantes del servidor).

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
glossaryId	✅	entero	El id del glosario (id del módulo del curso), tal como lo da get_course_structure
destDir	✅	texto	Una carpeta local absoluta

import_glossary

Importar entradas a un glosario

Importa las entradas de un archivo XML de glosario (como lo guarda export_glossary) a este glosario, como entradas de la persona, aprobadas; con categories, también sus categorías. Moodle rechaza duplicados donde el glosario no los admite, y entradas sin concepto o definición. Devuelve cuántas entraron. Cambia el curso: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
glossaryId	✅	entero	El id del glosario (id del módulo del curso), tal como lo da get_course_structure
file	✅	texto	Una ruta local absoluta al archivo XML
categories		sí o no	Traer las categorías de las entradas, añadiendo las que falten

list_wiki_pages

Listar las páginas de una wiki

Lista las páginas de una subwiki por título: el id de cada una, las páginas a las que enlaza (las que aún no existen, sin id) y su última versión (número, fecha y autor, un alias cuando el servidor seudonimiza). La subwiki de la persona salvo que groupId o participant elijan otra. Vacía mientras no tiene páginas. Una página cada vez: limit páginas (50 por defecto) tras saltar offset; more dice si hay más.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
wikiId	✅	entero	El id de la wiki (id del módulo del curso), tal como lo da get_course_structure
groupId		entero	La subwiki de un grupo, en una wiki con grupos; la de la propia persona si falta
participant		texto	La subwiki de un participante en una wiki individual, por su alias cuando el servidor seudonimiza
participantId		entero	O por su id de usuario, cuando el servidor muestra los nombres
limit		entero	Cuántas páginas (50 por defecto, hasta 200)
offset		entero	Cuántas páginas saltar antes (0 por defecto)

get_wiki_page

Leer una página de una wiki

Lee una página de una wiki: su contenido (HTML como lo muestra Moodle, su texto, imágenes y multimedia), sus secciones, las páginas a las que enlaza y su última versión; con history, todas las versiones, de la más nueva a la más antigua. Los autores como alias, y las páginas que escribieron otros redactadas, cuando el servidor seudonimiza.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
wikiId	✅	entero	El id de la wiki (id del módulo del curso), tal como lo da get_course_structure
pageId	✅	entero	El id de la página, tal como lo da list_wiki_pages
history		sí o no	También todas las versiones

create_wiki_page

Crear una página en una wiki

Crea una página en una subwiki como la persona, con su contenido (HTML en una wiki HTML, la de Moodle por defecto, o el marcado de la wiki; [[Título]] enlaza otra página): la subwiki de la persona salvo que groupId o participant elijan otra. La primera página de una subwiki debe llevar el título de primera página de la wiki. Devuelve la página. Otros del curso la leen: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
wikiId	✅	entero	El id de la wiki (id del módulo del curso), tal como lo da get_course_structure
title	✅	texto
content	✅	texto	Sin alias
embed		lista de texto	Archivos locales absolutos que incrustar en el contenido (páginas HTML), que nombra cada uno por su nombre de archivo: <img src="shot.png">
groupId		entero	La subwiki de un grupo, en una wiki con grupos; la de la propia persona si falta
participant		texto	La subwiki de un participante en una wiki individual, por su alias cuando el servidor seudonimiza
participantId		entero	O por su id de usuario, cuando el servidor muestra los nombres

edit_wiki_page

Editar una página de una wiki

Cambia el contenido de una página de una wiki, entera o una sección (un encabezado, tal como lo lista sections de get_wiki_page), como su editor: una versión nueva, de la persona. Se rechaza mientras otro tiene la página abierta en su editor: vuelve a intentarlo más tarde. Devuelve la página. Confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
wikiId	✅	entero	El id de la wiki (id del módulo del curso), tal como lo da get_course_structure
pageId	✅	entero	El id de la página, tal como lo da list_wiki_pages
content	✅	texto	Sustituye el de la página o el de la sección; sin alias
section		texto
embed		lista de texto	Archivos locales absolutos que incrustar en el contenido (páginas HTML), que nombra cada uno por su nombre de archivo: <img src="shot.png">

get_feedback_items

Leer las preguntas de un feedback

Lee los elementos de una actividad feedback tal como los monta su profesor, en orden: tipo (multichoice, multichoicerated, textfield, textarea, numeric, info, label, captcha, pagebreak), posición, pregunta, si es obligatorio, las opciones de una elección (con pesos si es valorada) y cómo se muestran, un rango numérico, el contenido de una etiqueta y el elemento del que depende.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
feedbackId	✅	entero	El id del feedback (id del módulo del curso), tal como lo da get_course_structure

add_feedback_item

Añadir una pregunta a un feedback

Añade un elemento a una actividad feedback, tras el elemento after (0: el primero; al final si falta): una pregunta de cualquier tipo con sus opciones y ajustes, una etiqueta con su contenido, o un salto de página o un CAPTCHA. Devuelve su id y los elementos en orden. Cambia el curso: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
feedbackId	✅	entero	El id del feedback (id del módulo del curso), tal como lo da get_course_structure
type	✅	multichoice, multichoicerated, textfield, textarea, numeric, info, label, captcha, pagebreak
question		texto	Todos los tipos salvo una etiqueta y un salto de página necesitan una
label		texto
required		sí o no
options		lista de objeto	Las opciones de los elementos de elección, en orden; si se dan, sustituyen a todas
display		radio, checkbox, dropdown	checkbox (varias respuestas) solo para multichoice
horizontal		sí o no
hideNotSelected		sí o no
ignoreEmpty		sí o no
range		objeto	El de un elemento numérico; un límite que falta es ninguno
info		response-time, course, category
contents		texto	El de una etiqueta (HTML)
dependsOn		objeto	Mostrarlo solo cuando otro elemento se respondió con este valor: un elemento con etiqueta, en una página anterior (con un salto de página entre ambos)
fields		objeto	Cualquier otro campo del formulario del elemento, por nombre (itemsize, itemmaxlength…)
after		entero	El elemento tras el que va (0: el primero)

edit_feedback_item

Cambiar una pregunta de un feedback

Cambia un elemento de un feedback con lo que se indica: la pregunta, la etiqueta, si es obligatorio, las opciones de una elección (si se dan, sustituyen a todas) y sus ajustes, un rango numérico, el contenido de una etiqueta, su dependencia (removeDependency la quita) y otros campos. Conserva su tipo y su sitio. Cambia el curso: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
feedbackId	✅	entero	El id del feedback (id del módulo del curso), tal como lo da get_course_structure
itemId	✅	entero	El id del elemento, tal como lo da get_feedback_items
question		texto	Todos los tipos salvo una etiqueta y un salto de página necesitan una
label		texto
required		sí o no
options		lista de objeto	Las opciones de los elementos de elección, en orden; si se dan, sustituyen a todas
display		radio, checkbox, dropdown	checkbox (varias respuestas) solo para multichoice
horizontal		sí o no
hideNotSelected		sí o no
ignoreEmpty		sí o no
range		objeto	El de un elemento numérico; un límite que falta es ninguno
info		response-time, course, category
contents		texto	El de una etiqueta (HTML)
dependsOn		objeto	Mostrarlo solo cuando otro elemento se respondió con este valor: un elemento con etiqueta, en una página anterior (con un salto de página entre ambos)
fields		objeto	Cualquier otro campo del formulario del elemento, por nombre (itemsize, itemmaxlength…)
removeDependency		sí o no

move_feedback_item

Mover una pregunta de un feedback

Mueve un elemento de un feedback a una posición (desde 1). Devuelve los elementos en orden. Cambia el curso: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
feedbackId	✅	entero	El id del feedback (id del módulo del curso), tal como lo da get_course_structure
itemId	✅	entero	El id del elemento, tal como lo da get_feedback_items
position	✅	entero

delete_feedback_item

Eliminar una pregunta de un feedback

Elimina un elemento de un feedback; las respuestas que dio la gente se van con él. Devuelve los elementos que quedan. No se puede deshacer: confírmalo antes con la persona. El servidor pide antes la confirmación de la persona en su aplicación (elicitation MCP); si dice que no, no pasa nada.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
feedbackId	✅	entero	El id del feedback (id del módulo del curso), tal como lo da get_course_structure
itemId	✅	entero	El id del elemento, tal como lo da get_feedback_items

list_feedback_templates

Listar las plantillas de feedback

Lista las plantillas que puede usar una actividad feedback: las del curso y las públicas del sitio.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
feedbackId	✅	entero	El id del feedback (id del módulo del curso), tal como lo da get_course_structure

use_feedback_template

Usar una plantilla en un feedback

Añade los elementos de una plantilla a una actividad feedback, tras los que tiene, o en su lugar con replace (sus respuestas se van con ellos). Devuelve los elementos. Cambia el curso: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
feedbackId	✅	entero	El id del feedback (id del módulo del curso), tal como lo da get_course_structure
templateId	✅	entero	Tal como lo da list_feedback_templates
replace		sí o no

save_feedback_template

Guardar un feedback como plantilla

Guarda los elementos de una actividad feedback como plantilla nueva: del curso, o pública (de todos los cursos, la de un gestor) con public. Devuelve su id. Confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
feedbackId	✅	entero	El id del feedback (id del módulo del curso), tal como lo da get_course_structure
name	✅	texto
public		sí o no

delete_feedback_template

Eliminar una plantilla de feedback

Elimina una plantilla de feedback (una pública requiere permisos de gestor). No se puede deshacer: confírmalo antes con la persona. El servidor pide antes la confirmación de la persona en su aplicación (elicitation MCP); si dice que no, no pasa nada.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
feedbackId	✅	entero	El id del feedback (id del módulo del curso), tal como lo da get_course_structure
templateId	✅	entero	Tal como lo da list_feedback_templates

Ciclo de vida del curso

Herramienta	Descripción	Solo lectura	Profesor	Alumno
copy_course	Copiar un curso		✓
backup_course	Hacer una copia de seguridad de un curso		✓
restore_course	Restaurar una copia de seguridad de un curso		✓
read_backup	Leer lo que contiene una copia de seguridad	✓	✓
anonymize_backup	Anonimizar una copia de seguridad	✓	✓
import_activities	Importar actividades de otro curso		✓
reset_course	Reiniciar un curso para un nuevo año		✓
copy_between_sites	Copiar contenido de un curso a otro sitio		✓

copy_course

Copiar un curso

Copia un curso en uno nuevo, como hace "Copiar curso" de Moodle: su contenido (y, con withUsers, las matriculaciones y los datos de sus personas) con un nuevo nombre completo y nombre corto, en una categoría (la del curso si no se indica), con fechas nuevas. Necesita permisos para hacer copias de seguridad, restaurar y crear cursos. Puede tardar minutos: Moodle lo hace por pasos, y espera hasta diez. Crea un curso: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
fullName	✅	texto
shortName	✅	texto
categoryId		entero
start		texto	El inicio del nuevo curso, ISO 8601
end		texto	El fin del nuevo curso, ISO 8601
withUsers		sí o no	También sus participantes y sus datos (por defecto false)
visible		sí o no

backup_course

Hacer una copia de seguridad de un curso

Hace una copia de seguridad de un curso en un archivo .mbz en una carpeta local, mediante el asistente de copia de seguridad de Moodle: su contenido, y con withUsers también los datos de sus personas (anonymize anonimiza sus nombres). O solo una parte: secciones (cada una con todo lo que contiene) y actividades, nunca con datos de personas, y con un archivo que no nombra a nadie ni ningún sitio salvo que anonymous sea false. Moodle guarda una copia en el área de copias de seguridad del curso. Se restaura con restore_course, en este sitio o en otro. Puede tardar minutos: Moodle lo hace por pasos, y espera hasta diez.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
destDir	✅	texto	Una carpeta local absoluta para el archivo
withUsers		sí o no	También los datos de sus participantes (por defecto false)
anonymize		sí o no	Con usuarios: Moodle anonimiza sus nombres y datos de contacto
sections		lista de entero	Solo estas secciones, por id (get_course_structure), cada una con todo lo que contiene
activities		lista de entero	Solo estas actividades y recursos, por id del módulo del curso
anonymous		sí o no	El archivo no nombra a ninguna persona ni el sitio o curso de origen: true por defecto con secciones o actividades, false con un curso entero

restore_course

Restaurar una copia de seguridad de un curso

Restaura una copia de seguridad .mbz mediante el asistente de restauración de Moodle: en un curso nuevo en una categoría (sin intoCourseId), o en un curso existente, añadiendo a su contenido (modo merge, el predeterminado) o sustituyéndolo (replace elimina antes el contenido del curso). Añadida a un curso, sectionId pone todas las actividades restauradas al final de esa sección, y afterSectionId las secciones de la copia como secciones nuevas después de esa; el resultado nombra las secciones y actividades nuevas, y warnings lo que quedó roto (restricciones o enlaces a lo que no se restauró) para que la persona lo arregle. Un curso nuevo toma los nombres de la copia de seguridad salvo que se indiquen fullName y shortName. Se rechaza una copia de un Moodle más nuevo, o con tipos de actividad que este sitio no ofrece. Puede tardar minutos: Moodle lo hace por pasos, y espera hasta diez. Cambia Moodle, y replace no se puede deshacer: confírmalo antes con la persona. El servidor pide antes la confirmación de la persona en su aplicación (elicitation MCP); si dice que no, no pasa nada.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
file	✅	texto	La ruta local absoluta de la copia de seguridad (.mbz)
intoCourseId		entero	Un curso existente en el que restaurar; un curso nuevo si falta
categoryId		entero	Para un curso nuevo: su categoría
mode		merge, replace	En un curso existente: añadir a él (por defecto) o sustituir su contenido
fullName		texto
shortName		texto
withUsers		sí o no	Restaurar los datos de los participantes que tenga la copia de seguridad (por defecto false)
sectionId		entero	Añadida a un curso: todas las actividades restauradas al final de esta sección
afterSectionId		entero	Añadida a un curso: las secciones de la copia como secciones nuevas después de esta

read_backup

Leer lo que contiene una copia de seguridad

Lee un archivo de copia de seguridad de Moodle (.mbz) en este ordenador sin restaurarlo, sin Moodle: el Moodle que lo hizo, el sitio y el curso de origen, sus secciones y actividades (con los ids del sitio de origen), los plugins que necesita un sitio para restaurarlo, si contiene datos de personas o el calificador, a qué se refiere cada actividad que la copia no contiene (restricciones sobre actividades que se quedaron fuera, enlaces a ellas, su categoría de calificación), que una restauración en otro sitio deja rotos, y qué nombra todavía a una persona, al sitio o al curso. Úsalo antes de restore_course o de compartir una copia.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
file	✅	texto	Una ruta local absoluta al archivo .mbz

anonymize_backup

Anonimizar una copia de seguridad

Escribe una copia de un archivo de copia de seguridad de Moodle (.mbz) que no nombra a nadie ni a ningún sitio, en este ordenador, sin Moodle: todos los ids de usuario a 0, los nombres de los autores vacíos, y la dirección del sitio de origen, el id y los nombres del curso y el registro de la copia sustituidos por valores neutros; el contenido (textos, ajustes, archivos) queda como estaba. Moodle la restaura como una copia de otro sitio. Se rechaza una copia con datos de personas (esas las hace el propio anonimizado de Moodle). Devuelve lo que se limpió. Para compartir una unidad con otros profesores.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
file	✅	texto	Una ruta local absoluta al archivo .mbz
destFile	✅	texto	Dónde escribir la copia (una ruta local absoluta; puede ser el propio file)

import_activities

Importar actividades de otro curso

Importa actividades de otro curso a un curso, como hace "Importar" de Moodle: todas, o solo activityIds, con sus secciones, nunca los datos de las personas. Devuelve los ids de las nuevas actividades. Puede tardar minutos: Moodle lo hace por pasos, y espera hasta diez. Cambia el curso: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
fromCourseId	✅	entero
toCourseId	✅	entero
activityIds		lista de entero	Solo estas actividades del otro curso (ids de módulos del curso)

reset_course

Reiniciar un curso para un nuevo año

Reinicia un curso como hace el formulario de reinicio de Moodle: elimina solo lo indicado en delete (entregas, intentos, mensajes, calificaciones… en cada actividad que los tenga), desmatricula a las personas con unenrolRoles, mueve la fecha de inicio (y con ella las fechas de las actividades) y establece cualquier otro campo del formulario por su nombre. No se elimina nada que no se indique. No se puede deshacer: confirma antes cada elemento con la persona. Devuelve el informe de Moodle. El servidor pide antes la confirmación de la persona en su aplicación (elicitation MCP); si dice que no, no pasa nada.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
delete		objeto
unenrolRoles		lista de entero	Ids de los roles cuyas personas se desmatriculan
start		texto	La nueva fecha de inicio, ISO 8601
fields		objeto	Cualquier otro campo del formulario de reinicio, por su nombre

copy_between_sites

Copiar contenido de un curso a otro sitio

Copia el contenido de un curso de uno de los sitios de este servidor a otro (list_sites): algunas actividades (activityIds), algunas secciones con todo lo que contienen (sectionIds) o, sin ninguna de las dos, el curso entero. Mediante la copia de seguridad de Moodle en el primer sitio y su restauración en el segundo, nunca con datos de personas y sin nombrar a nadie; el fichero se queda en este ordenador, nunca pasa por ti y se borra al terminar. Va a un curso existente (toCourseId): al final de una de sus secciones (toSectionId) o, para secciones, como secciones nuevas después de toAfterSectionId; un curso entero puede ir en su lugar a un curso nuevo en una categoría (toCategoryId). Devuelve lo que se ha creado, y en warnings lo que quedó roto (restricciones o enlaces a lo que no se copió) para que la persona lo arregle. Cada sitio necesita una sesión (use_site y después login). El sitio activo sigue siendo el mismo. Dentro de un mismo sitio, usa import_activities o copy_course. Puede tardar minutos. Cambia el sitio de destino: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
fromSite	✅	texto	El nombre de un sitio, tal como lo da list_sites
courseId	✅	entero	El curso del que copiar, en fromSite
activityIds		lista de entero	Solo estas actividades y recursos, por id del módulo del curso
sectionIds		lista de entero	Solo estas secciones, por id, cada una con todo lo que contiene
toSite	✅	texto	El nombre de un sitio, tal como lo da list_sites
toCourseId		entero	Un curso existente en toSite al que copiar
toSectionId		entero	En toCourseId: todas las actividades copiadas al final de esta sección
toAfterSectionId		entero	En toCourseId: las secciones copiadas como secciones nuevas después de esta
toCategoryId		entero	Solo un curso entero: un curso nuevo en esta categoría de toSite, en lugar de toCourseId

Tareas y calificación

Herramienta	Descripción	Solo lectura	Profesor	Alumno
list_assignments	Listar las tareas de un curso	✓	✓	✓
get_submissions	Obtener las entregas de una tarea	✓	✓
get_rubric	Obtener los criterios de calificación de una tarea	✓	✓
set_rubric	Definir la rúbrica o la guía de evaluación de una tarea		✓
grade_submission	Calificar una entrega		✓
grant_extension	Conceder una prórroga en una tarea		✓
set_workflow_state	Establecer el estado del flujo de trabajo de calificación		✓
allocate_marker	Asignar un evaluador a entregas		✓

list_assignments

Listar las tareas de un curso

Lista las tareas de un curso de Moodle: sus ids (ids de módulo del curso, para las demás herramientas de tareas), nombres, URL, visibilidad y sección. Toma el id del curso de list_courses.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero	El id del curso, tal como lo da list_courses

get_submissions

Obtener las entregas de una tarea

Obtiene las entregas de los participantes en una tarea de Moodle, por páginas (limit participantes, 25 por defecto, tras saltarse offset; more dice si hay más): quién (un alias cuando el servidor seudonimiza, si no, id y nombre), estado (submitted; draft; new: una entrega iniciada pero aún sin nada; reopened; none: ninguna entrega), si necesita calificación, prórrogas, las fechas del participante y, por defecto, el contenido (texto en línea y enlaces a archivos; los nombres y datos de contacto que contenga se ocultan al seudonimizar). No cambia nada, pero Moodle lo registra como el profesor viendo las páginas de calificación, igual que con su propio calificador. Toma el id de la tarea de list_assignments.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
assignmentId	✅	entero	El id de la tarea (su id de módulo del curso), tal como lo da list_assignments
includeContent		sí o no	Incluir el contenido de cada entrega: texto en línea y enlaces a archivos (true por defecto)
limit		entero	Cuántos participantes (25 por defecto, hasta 200)
offset		entero	Cuántos participantes saltarse primero, en el orden de la tabla de calificación (0 por defecto)

get_rubric

Obtener los criterios de calificación de una tarea

Lee cómo se califica una tarea: simple (una nota o una escala), una rúbrica (criterios con sus niveles y puntuaciones) o una guía de evaluación (criterios con su puntuación máxima). Los ids de criterio y de nivel son lo que toman los campos de grade_submission. Toma el id de la tarea de list_assignments; necesita al menos un participante.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
assignmentId	✅	entero	El id de la tarea (id del módulo del curso), tal como lo da list_assignments

set_rubric

Definir la rúbrica o la guía de evaluación de una tarea

Define cómo se califica una tarea con una rúbrica (criterios, cada uno con dos niveles o más: una definición y su puntuación) o con una guía de evaluación (criterios, cada uno con un nombre corto, una descripción para los estudiantes, otra para los evaluadores y una puntuación máxima, y los comentarios frecuentes de la guía), mediante el editor de calificación avanzada de Moodle, lista para usarse. Crea una donde no la hay y sustituye la que hay, así que cambian los ids de sus criterios y niveles. Se rechaza en cuanto se ha calificado algo con ella: Moodle recalificaría. Devuelve la definición tal como la da get_rubric. Cambia cómo se califica a los estudiantes: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
assignmentId	✅	entero	El id de la tarea (id del módulo del curso), tal como lo da list_assignments
method	✅	rubric, guide
name	✅	texto	Su nombre, tal como lo lista la página de calificación avanzada
description		texto	Su descripción (HTML)
criteria	✅	lista de objeto	En orden
comments		lista de texto	Los comentarios frecuentes de una guía de evaluación, en orden

grade_submission

Calificar una entrega

Califica a un participante en una tarea, como hace el calificador de Moodle: una nota (calificación simple), los niveles de una rúbrica o las puntuaciones de una guía de evaluación por criterio (ids de get_rubric) con observaciones, comentarios de retroalimentación (HTML, cuando la tarea los tiene activados), si notificar al estudiante, y cualquier otro campo de calificación por nombre en fields. Toma al participante tal como lo da get_submissions: user (un alias) cuando el servidor seudonimiza; si no, userId. Funciona con o sin entrega. Devuelve la calificación guardada. Cambia calificaciones que los estudiantes pueden ver: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
assignmentId	✅	entero	El id de la tarea (id del módulo del curso), tal como lo da list_assignments
user		texto	El alias del participante, tal como lo dan las herramientas de lectura cuando el servidor seudonimiza
userId		entero	El id de usuario del participante, cuando el servidor muestra los nombres
grade		texto	La nota como texto: un número dentro del rango ("7.5"), o un elemento de la escala
feedback		texto	Comentarios de retroalimentación (HTML); sin alias, ya que el estudiante los lee
notify		sí o no	Notificar al estudiante; lo predeterminado de Moodle si falta
rubric		objeto	El nivel de una rúbrica por criterio: id de criterio → id de nivel, tal como los da get_rubric
guide		objeto	La puntuación de una guía de evaluación por criterio: id de criterio → puntuación
remarks		objeto	Observaciones por criterio de una rúbrica o guía: id de criterio → texto; sin alias
feedbackFiles		lista de texto	Rutas locales absolutas de archivos de retroalimentación que devolver al estudiante
workflowState		notmarked, inmarking, readyforreview, inreview, readyforrelease, released	Con el flujo de trabajo de calificación activado: el estado en que dejar la entrega ("released" muestra la calificación al estudiante)
applyToGroup		sí o no	En una tarea en grupo: dar la misma calificación y los mismos comentarios a todo el grupo
fields		objeto	Otros campos del formulario de calificación por nombre, p. ej., los niveles de una rúbrica

grant_extension

Conceder una prórroga en una tarea

Concede a participantes una prórroga de la fecha de entrega de una tarea hasta una fecha, como hace el formulario de prórroga de la tarea (varios a la vez). Los toma tal como los da get_submissions: users (alias) cuando el servidor seudonimiza; si no, userIds. Moodle rechaza una fecha anterior a la fecha de entrega. Confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
assignmentId	✅	entero	El id de la tarea (id del módulo del curso), tal como lo da list_assignments
users		lista de texto	Los alias de los participantes, cuando el servidor seudonimiza
userIds		lista de entero	Los ids de usuario de los participantes, cuando el servidor muestra los nombres
until	✅	texto	ISO 8601, p. ej., 2026-11-03T23:59:00+01:00

set_workflow_state

Establecer el estado del flujo de trabajo de calificación

Establece el estado del flujo de trabajo de calificación de las entregas de participantes, como hace la acción en bloque de la tabla de calificación: "released" les muestra sus calificaciones (notify se lo comunica). Los toma tal como los da get_submissions. Los estudiantes pueden verlo: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
assignmentId	✅	entero	El id de la tarea (id del módulo del curso), tal como lo da list_assignments
users		lista de texto	Los alias de los participantes, tal como los dan las herramientas de lectura cuando el servidor seudonimiza
userIds		lista de entero	Los ids de usuario de los participantes, cuando el servidor muestra los nombres
state	✅	inmarking, readyforreview, inreview, readyforrelease, released
notify		sí o no

allocate_marker

Asignar un evaluador a entregas

Asigna un evaluador (alguien que puede calificar; varios donde la tarea usa varios por entrega) a las entregas de participantes, como hace la acción en bloque de la tabla de calificación; Moodle no toca las entregas que ya han pasado la evaluación. Participantes y evaluadores tal como los da get_submissions: alias cuando el servidor seudonimiza. Confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
assignmentId	✅	entero	El id de la tarea (id del módulo del curso), tal como lo da list_assignments
users		lista de texto	Los alias de los participantes, tal como los dan las herramientas de lectura cuando el servidor seudonimiza
userIds		lista de entero	Los ids de usuario de los participantes, cuando el servidor muestra los nombres
markers		lista de texto	Los alias de los evaluadores, cuando el servidor seudonimiza
markerIds		lista de entero	Los ids de usuario de los evaluadores, cuando el servidor muestra los nombres

Cuestionarios y preguntas

Herramienta	Descripción	Solo lectura	Profesor	Alumno
list_question_banks	Listar los bancos de preguntas de un curso	✓	✓
list_question_types	Listar los tipos de pregunta que ofrece el sitio	✓	✓
list_questions	Listar las preguntas de un banco	✓	✓
validate_gift	Comprobar preguntas GIFT antes de importarlas	✓	✓
import_questions	Importar preguntas a un banco		✓
create_question	Crear una pregunta en un banco		✓
update_question	Cambiar una pregunta de un banco		✓
delete_questions	Eliminar preguntas de un banco		✓
set_question_status	Marcar una pregunta como lista o borrador		✓
list_question_categories	Listar las categorías de un banco de preguntas	✓	✓
add_question_category	Añadir una categoría a un banco de preguntas		✓
edit_question_category	Renombrar o mover una categoría de preguntas		✓
delete_question_category	Eliminar una categoría de preguntas		✓
move_questions	Mover preguntas a otra categoría		✓
export_questions	Exportar las preguntas de un banco a un archivo	✓	✓
get_quiz_structure	Obtener las preguntas de un cuestionario	✓	✓
add_questions_to_quiz	Añadir preguntas a un cuestionario		✓
edit_quiz_slot	Cambiar la puntuación o la posición de una pregunta de un cuestionario		✓
remove_quiz_slot	Quitar una pregunta de un cuestionario		✓
set_quiz_pages	Establecer las páginas de un cuestionario		✓
add_quiz_section	Añadir una sección a un cuestionario		✓
get_quiz_results	Obtener los resultados de un cuestionario	✓	✓
get_quiz_statistics	Leer las estadísticas de un cuestionario	✓	✓
set_quiz_override	Establecer una excepción de cuestionario para un participante		✓
list_questions_to_grade	Listar las preguntas de un cuestionario por calificar a mano	✓	✓
grade_quiz_question	Calificar a mano una pregunta de cuestionario		✓

list_question_banks

Listar los bancos de preguntas de un curso

Lista los bancos de preguntas de un curso: sus bancos compartidos (utilizables por cualquier cuestionario del curso) y los bancos propios de las actividades (el de un cuestionario, utilizable solo en él). Devuelve sus ids, que reciben list_questions, import_questions y create_question. En Moodle 4.x un curso tiene un solo banco, el suyo, cuyo id es el del curso.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero

list_question_types

Listar los tipos de pregunta que ofrece el sitio

Lista los tipos de pregunta que tiene activados el sitio, tal como te los ofrece el selector «Crear una nueva pregunta» del banco: el nombre interno de cada uno (el tipo que recibe create_question), el nombre y la descripción que muestra Moodle, si es un plugin y su grupo ("question" para los tipos que preguntan algo, "other" para una descripción). Consúltalo antes de elegir un tipo de pregunta: puede tener más tipos de los que create_question sabe crear (21) o menos, y funciona en un curso que aún no tiene preguntas. Vacío si puedes ver el banco pero no añadirle preguntas. Recibe el id del banco de list_question_banks.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
bankId	✅	entero	El id del banco (un id de módulo del curso), tal como lo da list_question_banks

list_questions

Listar las preguntas de un banco

Lista las categorías de un banco de preguntas y las preguntas que contienen, categoría a categoría: id, nombre, tipo, estado y categoría. Por páginas: limit preguntas (100 por defecto) tras saltarse offset; more dice si hay más. Recibe el id del banco de list_question_banks.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
bankId	✅	entero	El id del banco (un id de módulo del curso), tal como lo da list_question_banks
limit		entero	Cuántas preguntas (100 por defecto, hasta 1000)
offset		entero	Cuántas preguntas saltarse primero, categoría a categoría (0 por defecto)

validate_gift

Comprobar preguntas GIFT antes de importarlas

Comprueba preguntas en GIFT antes de import_questions, sin Moodle: cada pregunta, separada por líneas en blanco como hace el importador de Moodle, con su tipo en los nombres de Moodle, título, texto y respuestas, y cada problema con su línea (una pregunta que Moodle no puede leer, un peso que no admite, una opción múltiple sin respuesta correcta, una pregunta de emparejamiento con menos de dos parejas); también las preguntas de ordenación en su propio GIFT ({>…}), como las exporta Moodle. Corrige lo que indique y vuelve a comprobar; valid significa que Moodle debería importar todas las preguntas.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
text		texto	Las preguntas en GIFT
file		texto	O una ruta local absoluta a un archivo GIFT

import_questions

Importar preguntas a un banco

Importa preguntas a un banco de preguntas desde GIFT o Moodle XML, dadas como texto o como archivo local, mediante el formulario de importación del banco: la forma de añadir varias a la vez. Moodle comprueba antes todo el archivo: si no puede analizarlo, no se importa nada y se devuelven sus mensajes. Devuelve las preguntas creadas. Cambia el banco: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
bankId	✅	entero	El id del banco (un id de módulo del curso), tal como lo da list_question_banks
format	✅	gift, xml
text		texto	Las preguntas en ese formato
file		texto	O una ruta absoluta a un archivo local en ese formato
categoryId		entero	La categoría del banco, tal como la da list_questions; la predeterminada del banco si falta

create_question

Crear una pregunta en un banco

Crea una pregunta en un banco de preguntas con el formulario de su tipo, de cualquier tipo: multichoice, truefalse, shortanswer, numerical, essay, calculadas (también simple y de opción múltiple), match, randomsamatch, arrastrar y soltar sobre texto (ddwtos), sobre una imagen (ddimageortext), marcadores (ddmarker), seleccionar palabras perdidas (gapselect), Cloze (multianswer, con sus respuestas en el texto), ordering, description, y los plugins coderunner, formulas, gapfill y ddmatch donde el sitio los tiene. Cada tipo admite sus propias entradas, comprobadas antes de Moodle. El texto lleva los huecos del tipo: [[1]] en ddwtos y gapselect, {1:SHORTANSWER:=Paris} en Cloze, [huecos] en gapfill, {comodines} en las calculadas. Para varias, import_questions es más rápido. Devuelve el id de la nueva pregunta. Cambia el banco: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
bankId	✅	entero	El id del banco (un id de módulo del curso), tal como lo da list_question_banks
type	✅	multichoice, truefalse, shortanswer, numerical, essay, calculated, calculatedsimple, calculatedmulti, match, randomsamatch, ddwtos, ddimageortext, ddmarker, gapselect, multianswer, ordering, description, coderunner, formulas, gapfill, ddmatch
name	✅	texto
text	✅	texto	El texto de la pregunta (HTML)
answers		lista de objeto	Respuestas de multichoice, shortanswer y numerical; las de los tipos calculados son fórmulas de los comodines ({a} + {b})
correct		sí o no	Truefalse: la respuesta correcta
pairs		lista de objeto	match, ddmatch: cada pregunta y su respuesta; una respuesta sin pregunta es un distractor
choose		entero	randomsamatch: cuántas preguntas de respuesta corta de la categoría toma
choices		lista de objeto	ddwtos, gapselect: las opciones que nombran [[1]], [[2]]… del texto, por posición
image		texto	ddimageortext, ddmarker: la imagen de fondo, una ruta local absoluta
drags		lista de objeto	ddimageortext: los elementos que se arrastran
markers		lista de objeto	ddmarker: los marcadores
drops		lista de objeto	ddimageortext, ddmarker: dónde van los elementos o marcadores
items		lista de texto	ordering: los elementos, en el orden correcto
wildcards		lista de objeto	calculated, calculatedsimple, calculatedmulti: los valores de cada {comodín}; los de Moodle, de 1 a 10, si faltan
sets		entero	Tipos calculados: cuántos juegos de valores (10 por defecto)
coderunner		objeto	coderunner (un plugin)
formulas		objeto	formulas (un plugin)
categoryId		entero	La categoría del banco, tal como la da list_questions; la predeterminada del banco si falta
defaultMark		número
fields		objeto	Cualquier otro campo del formulario del tipo, por su nombre

update_question

Cambiar una pregunta de un banco

Cambia una pregunta de un banco con el formulario de su tipo, con las entradas de create_question: solo cambia lo que se indica (una lista dada, como answers, pairs, choices, items, drags, markers, drops o los valores de un comodín, sustituye a la de la pregunta). Guardar crea una versión nueva con su propio id, el que se devuelve, que reciben desde entonces los cuestionarios que usan la última versión. Cambia el banco: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
bankId	✅	entero	El id del banco (un id de módulo del curso), tal como lo da list_question_banks
questionId	✅	entero	Tal como lo da list_questions
name		texto
text		texto	El texto de la pregunta (HTML)
answers		lista de objeto	Respuestas de multichoice, shortanswer y numerical; las de los tipos calculados son fórmulas de los comodines ({a} + {b})
correct		sí o no	Truefalse: la respuesta correcta
pairs		lista de objeto	match, ddmatch: cada pregunta y su respuesta; una respuesta sin pregunta es un distractor
choose		entero	randomsamatch: cuántas preguntas de respuesta corta de la categoría toma
choices		lista de objeto	ddwtos, gapselect: las opciones que nombran [[1]], [[2]]… del texto, por posición
image		texto	ddimageortext, ddmarker: la imagen de fondo, una ruta local absoluta
drags		lista de objeto	ddimageortext: los elementos que se arrastran
markers		lista de objeto	ddmarker: los marcadores
drops		lista de objeto	ddimageortext, ddmarker: dónde van los elementos o marcadores
items		lista de texto	ordering: los elementos, en el orden correcto
wildcards		lista de objeto	calculated, calculatedsimple, calculatedmulti: los valores de cada {comodín}; los de Moodle, de 1 a 10, si faltan
sets		entero	Tipos calculados: cuántos juegos de valores (10 por defecto)
coderunner		objeto	coderunner (un plugin)
formulas		objeto	formulas (un plugin)
categoryId		entero	La categoría del banco, tal como la da list_questions; la predeterminada del banco si falta
defaultMark		número
fields		objeto	Cualquier otro campo del formulario del tipo, por su nombre

delete_questions

Eliminar preguntas de un banco

Elimina preguntas de un banco, todas las versiones de cada una, como hace la acción de eliminar del banco. Moodle no elimina una pregunta que usa un cuestionario: la oculta, y hidden enumera esas. No se puede deshacer: confírmalo antes con la persona. El servidor pide antes la confirmación de la persona en su aplicación (elicitation MCP); si dice que no, no pasa nada.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
bankId	✅	entero	El id del banco (un id de módulo del curso), tal como lo da list_question_banks
questionIds	✅	lista de entero	Tal como los da list_questions

set_question_status

Marcar una pregunta como lista o borrador

Marca una pregunta del banco como lista (los cuestionarios pueden usarla) o como borrador, como hace el menú de estado del banco.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
questionId	✅	entero	Tal como lo da list_questions
status	✅	ready, draft

list_question_categories

Listar las categorías de un banco de preguntas

Lista las categorías de un banco de preguntas tal como las muestra su página de categorías, las madres antes que sus subcategorías: id, nombre, categoría madre, descripción y cuántas preguntas hay directamente en cada una. La categoría oculta Top del banco es la madre de las de primer nivel. Requiere gestionar las categorías del banco (lo hace un profesor).

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
bankId	✅	entero	El id del banco, tal como lo da list_question_banks (en Moodle 4.x, el id del curso)

add_question_category

Añadir una categoría a un banco de preguntas

Añade una categoría a un banco de preguntas, en el primer nivel o dentro de parentId, con una descripción opcional (HTML). Devuelve la categoría. Cambia el banco: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
bankId	✅	entero	El id del banco, tal como lo da list_question_banks (en Moodle 4.x, el id del curso)
name	✅	texto
parentId		entero
description		texto

edit_question_category

Renombrar o mover una categoría de preguntas

Cambia una categoría de un banco de preguntas: su nombre, su descripción (HTML) o su categoría madre (la mueve con sus subcategorías y preguntas; la Top del banco la lleva al primer nivel). Solo cambia lo que se indica. Cambia el banco: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
bankId	✅	entero	El id del banco, tal como lo da list_question_banks (en Moodle 4.x, el id del curso)
categoryId	✅	entero	El id de la categoría, tal como lo da list_question_categories
name		texto
description		texto
parentId		entero

delete_question_category

Eliminar una categoría de preguntas

Elimina una categoría de un banco de preguntas: sus subcategorías suben a su categoría madre; una con preguntas necesita moveTo, la categoría a la que van sus preguntas. Moodle conserva la última categoría de primer nivel de un banco. Confírmalo antes con la persona. El servidor pide antes la confirmación de la persona en su aplicación (elicitation MCP); si dice que no, no pasa nada.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
bankId	✅	entero	El id del banco, tal como lo da list_question_banks (en Moodle 4.x, el id del curso)
categoryId	✅	entero	El id de la categoría, tal como lo da list_question_categories
moveTo		entero	A dónde van sus preguntas, si tiene

move_questions

Mover preguntas a otra categoría

Mueve preguntas de un banco a una de sus categorías, varias a la vez; cada una conserva su id y sus versiones. Cambia el banco: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
bankId	✅	entero	El id del banco, tal como lo da list_question_banks (en Moodle 4.x, el id del curso)
questionIds	✅	lista de entero	Tal como las da list_questions
categoryId	✅	entero	El id de la categoría, tal como lo da list_question_categories

export_questions

Exportar las preguntas de un banco a un archivo

Guarda las preguntas de un banco, o las de una categoría con sus subcategorías, en un archivo local GIFT o Moodle XML: la última versión de cada pregunta, sin las ocultas, con sus categorías, para que import_questions las vuelva a crear. validate_gift lee de vuelta una exportación GIFT.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
bankId	✅	entero	El id del banco, tal como lo da list_question_banks (en Moodle 4.x, el id del curso)
format	✅	gift, xml
categoryId		entero	Solo esta categoría; todo el banco si falta
file	✅	texto	Una ruta local absoluta (se sustituye si existe)

get_quiz_structure

Obtener las preguntas de un cuestionario

Lista las preguntas de un cuestionario como lo hace su página de edición, en orden: la página de cada hueco, el id de la pregunta, el tipo (o aleatoria), el nombre y la puntuación. Solo para profesores.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
quizId	✅	entero	El id del cuestionario (id del módulo del curso), tal como lo da get_course_structure

add_questions_to_quiz

Añadir preguntas a un cuestionario

Añade preguntas a un cuestionario: preguntas del banco por id (de list_questions) y/o preguntas aleatorias de una categoría del banco, al final o en una página dada. Un cuestionario que ya tiene intentos no puede cambiar sus preguntas: Moodle lo rechaza. Devuelve la estructura del cuestionario tras el cambio. Cambia el cuestionario: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
quizId	✅	entero	El id del cuestionario (id del módulo del curso), tal como lo da get_course_structure
questionIds		lista de entero	Preguntas del banco, tal como las da list_questions
random		objeto	Preguntas aleatorias tomadas de una categoría
page		entero	La página a la que añadirlas; la última si falta

edit_quiz_slot

Cambiar la puntuación o la posición de una pregunta de un cuestionario

Cambia un hueco de un cuestionario: su puntuación máxima y dónde está (después de otro hueco, 0 para el primero, y en una página), como hace la página de edición. Tras los intentos, Moodle permite cambiar la puntuación (los recalifica) pero no el orden. Devuelve la estructura del cuestionario. Cambia el cuestionario: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
quizId	✅	entero	El id del cuestionario (id del módulo del curso), tal como lo da get_course_structure
slot	✅	entero	La posición del hueco en el cuestionario, desde 1, tal como la da get_quiz_structure
maxMark		número
moveAfter		entero	Ponerlo después de este hueco (0: el primero)
page		entero	La página en la que ponerlo

remove_quiz_slot

Quitar una pregunta de un cuestionario

Quita un hueco de un cuestionario, como hace el icono de eliminar de la página de edición; la pregunta sigue en su banco. Un cuestionario con intentos no puede cambiar sus preguntas. Devuelve la estructura del cuestionario. Confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
quizId	✅	entero	El id del cuestionario (id del módulo del curso), tal como lo da get_course_structure
slot	✅	entero	La posición del hueco en el cuestionario, desde 1, tal como la da get_quiz_structure

set_quiz_pages

Establecer las páginas de un cuestionario

Establece cómo se reparten en páginas las preguntas de un cuestionario: perPage preguntas por página (0 para todas en una), como hace "Repaginar", o saltos de página exactamente después de los huecos de breaksAfter. Devuelve la estructura del cuestionario. Cambia el cuestionario: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
quizId	✅	entero	El id del cuestionario (id del módulo del curso), tal como lo da get_course_structure
perPage		entero	Preguntas por página; 0 para una sola página
breaksAfter		lista de entero	O bien: un salto de página después de cada uno de estos huecos, y en ningún otro sitio

add_quiz_section

Añadir una sección a un cuestionario

Añade un encabezado de sección a un cuestionario, empezando en un hueco (el primero de su página: ver set_quiz_pages), opcionalmente barajando sus preguntas. Devuelve el id de la nueva sección y la estructura del cuestionario. Cambia el cuestionario: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
quizId	✅	entero	El id del cuestionario (id del módulo del curso), tal como lo da get_course_structure
firstSlot	✅	entero	La posición del hueco en el cuestionario, desde 1, tal como la da get_quiz_structure
heading	✅	texto
shuffle		sí o no

get_quiz_results

Obtener los resultados de un cuestionario

Lee los intentos de un cuestionario tal como los muestra su informe de calificaciones: por intento, el participante (un alias cuando el servidor seudonimiza), estado, fechas, calificación y la puntuación por pregunta; con responses, también cada respuesta dada (oculta al seudonimizar). Por páginas: limit intentos (50 por defecto) tras saltarse offset; more dice si hay más.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
quizId	✅	entero	El id del cuestionario (id del módulo del curso), tal como lo da get_course_structure
responses		sí o no	También la respuesta por pregunta (por defecto false)
limit		entero	Cuántos intentos (50 por defecto, hasta 500)
offset		entero	Cuántos intentos saltarse primero, en el orden del informe (0 por defecto)

get_quiz_statistics

Leer las estadísticas de un cuestionario

Lee el informe de estadísticas de un cuestionario, que dice qué preguntas funcionan: las cifras del cuestionario (intentos, medias, mediana, desviación típica, asimetría, curtosis, consistencia interna, ratio de error, error típico) y, por pregunta, su índice de facilidad, desviación típica, pesos, índice y eficiencia de discriminación, con las dudosas marcadas; las preguntas de un hueco aleatorio y las variantes, cada una con las suyas; con responses, cuántas veces se dio cada respuesta (se lee una página por pregunta). Las cifras como las muestra el informe. attempts elige qué intentos cuentan; recalculate borra lo que tenía Moodle guardado. Solo datos agregados: ninguna persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
quizId	✅	entero	El id del cuestionario (id del módulo del curso), tal como lo da get_course_structure
attempts		highest, all, first, last	El método de calificación del cuestionario por defecto
recalculate		sí o no	Calcularlo de nuevo ahora, para los intentos terminados desde entonces
responses		sí o no	También el análisis de respuestas de cada pregunta

set_quiz_override

Establecer una excepción de cuestionario para un participante

Da a un participante sus propios ajustes del cuestionario, como hacen las excepciones de usuario del cuestionario: fechas de apertura y cierre, límite de tiempo en minutos o número de intentos (0 ilimitados); lo que no se indica sigue siendo lo del cuestionario. Toma al participante tal como lo da list_participants. Confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
quizId	✅	entero	El id del cuestionario (id del módulo del curso)
user		texto	El alias del participante, tal como lo dan las herramientas de lectura cuando el servidor seudonimiza
userId		entero	El id de usuario del participante, cuando el servidor muestra los nombres
open		texto	ISO 8601
close		texto	ISO 8601
timeLimitMinutes		entero
attempts		entero	0 para ilimitados

list_questions_to_grade

Listar las preguntas de un cuestionario por calificar a mano

Lista las preguntas de un cuestionario que esperan calificación manual (ensayos…), cada una con cuántas hay por calificar y los intentos terminados cuya respuesta lo necesita (por id de intento, con el participante como alias cuando el servidor seudonimiza). Lee una respuesta con get_attempt_review; califícala con grade_quiz_question.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
quizId	✅	entero	El id del cuestionario (id del módulo del curso)

grade_quiz_question

Calificar a mano una pregunta de cuestionario

Califica a mano una pregunta de un intento terminado, con un comentario, como hace "Comentar o sobrescribir la puntuación" de la revisión: un ensayo que espera calificación, o cualquier pregunta cuya puntuación se sobrescribe. La puntuación va en los puntos de la pregunta (de 0 a su máximo). Devuelve después la calificación del intento cuando se muestra. Los estudiantes pueden verla: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
attemptId	✅	entero	Tal como lo da list_questions_to_grade
slot	✅	entero
mark	✅	número
comment		texto	Sin alias, ya que el estudiante lo lee

Calificador y progreso

Herramienta	Descripción	Solo lectura	Profesor	Alumno
get_grader_report	Obtener las calificaciones de un curso	✓	✓
set_grade	Poner una calificación en el libro de calificaciones		✓
export_grades	Exportar las calificaciones de un curso a un archivo	✓	✓
get_gradebook_setup	Obtener la configuración del libro de calificaciones de un curso	✓	✓
add_grade_item	Añadir un elemento de calificación manual		✓
update_grade_item	Actualizar un elemento de calificación		✓
delete_grade_item	Eliminar un elemento de calificación manual		✓
add_grade_category	Añadir una categoría de calificación		✓
update_grade_category	Actualizar una categoría de calificación		✓
delete_grade_category	Eliminar una categoría de calificación		✓
import_grades	Importar calificaciones desde un archivo CSV		✓
list_scales	Listar las escalas de un curso	✓	✓
add_scale	Añadir una escala a un curso		✓
edit_scale	Cambiar una escala de un curso		✓
get_grade_letters	Leer las letras de calificación de un curso	✓	✓
set_grade_letters	Fijar las letras de calificación de un curso		✓
get_completion_report	Obtener la finalización de actividades de un curso	✓	✓
override_completion	Establecer la finalización de una actividad de un participante		✓
get_course_completion_criteria	Leer los criterios de finalización de un curso	✓	✓
set_course_completion_criteria	Fijar qué completa un curso		✓
get_course_completion_status	Leer quién ha completado un curso	✓	✓
mark_course_complete	Marcar la finalización del curso de un participante		✓

get_grader_report

Obtener las calificaciones de un curso

Lee las calificaciones de todos en un curso tal como las muestra el informe del calificador, de un solo grupo si se indica: sus columnas (elementos de calificación, categorías, el total del curso) y una fila por participante (un alias cuando el servidor seudonimiza) con sus calificaciones.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
group		entero	Solo los miembros de este grupo, por su id de list_groups

set_grade

Poner una calificación en el libro de calificaciones

Pone la calificación de un participante en un elemento de calificación, como hace la vista individual del libro de calificaciones: un elemento manual la recibe; la de una actividad o una categoría se anula (hasta que override false quita la anulación). También comentarios de retroalimentación y excluirla de los totales. La calificación como texto: puntos ("7.5"), un elemento de una escala, o "none" para vaciarla. Los estudiantes pueden verla: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
itemId	✅	entero	El elemento de calificación, tal como lo dan get_gradebook_setup o get_grader_report
user		texto	El alias del participante, tal como lo dan las herramientas de lectura cuando el servidor seudonimiza
userId		entero	El id de usuario del participante, cuando el servidor muestra los nombres
grade		texto
feedback		texto	Sin alias, ya que lo lee el estudiante
override		sí o no	false: quitar la anulación de una actividad o una categoría
excluded		sí o no	Excluirla de los totales

export_grades

Exportar las calificaciones de un curso a un archivo

Guarda las calificaciones de un curso en una carpeta local tal como Moodle las exporta para un profesor: una hoja de cálculo (xlsx, ods), CSV o XML, con los elementos, el grupo, la visualización y los comentarios de retroalimentación elegidos. El archivo nombra a cada participante: solo con nombres en claro (el nivel de datos de estudiantes del servidor), ya que un archivo no se puede seudonimizar.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
format	✅	xlsx, ods, csv, xml
destDir	✅	texto	Una carpeta local absoluta
itemIds		lista de entero	Solo estos elementos de calificación
groupId		entero
display		lista de real, percentage, letter
feedback		sí o no	Incluir los comentarios de retroalimentación

get_gradebook_setup

Obtener la configuración del libro de calificaciones de un curso

Lee cómo se calculan las calificaciones de un curso, como lo muestra la página de configuración del libro de calificaciones: sus categorías (agregación, peso, máximo) y sus elementos de calificación (categoría, máximo, peso). No incluye las calificaciones de nadie.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero

add_grade_item

Añadir un elemento de calificación manual

Añade un elemento de calificación que se califica en el libro de calificaciones (no mediante una actividad): sobre maxGrade (por defecto 100 en Moodle) o con una escala, en el nivel superior o en una categoría, opcionalmente oculto a los estudiantes. Lo devuelve tal como lo muestra la configuración. Cambia cómo se calculan las calificaciones: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
name	✅	texto
maxGrade		número
scaleId		entero	Una escala en lugar de puntos
categoryId		entero	La categoría en la que ponerlo, tal como la da get_gradebook_setup
hidden		sí o no

update_grade_item

Actualizar un elemento de calificación

Cambia un elemento de calificación de get_gradebook_setup: moverlo a una categoría, establecer su peso (porcentaje, que sustituye al automático) o la calificación máxima de un elemento manual (la de una actividad se establece en la actividad). Devuelve el elemento tras el cambio. Cambia cómo se calculan las calificaciones: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
itemId	✅	entero
category		entero	La categoría a la que moverlo
weight		número	Porcentaje
maxGrade		número

delete_grade_item

Eliminar un elemento de calificación manual

Elimina un elemento de calificación manual y todas sus calificaciones. El elemento de una actividad va con su actividad, así que se rechaza. No se puede deshacer: confírmalo antes con la persona. El servidor pide antes la confirmación de la persona en su aplicación (elicitation MCP); si dice que no, no pasa nada.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
itemId	✅	entero

add_grade_category

Añadir una categoría de calificación

Añade una categoría de calificación al libro de calificaciones de un curso, en el nivel superior o dentro de otra, con su agregación. La devuelve tal como la muestra la configuración. Cambia cómo se calculan las calificaciones: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
name	✅	texto
aggregation		mean, median, lowest, highest, mode, weighted-mean, simple-weighted-mean, mean-with-extra-credits, natural
parentId		entero	La categoría en la que ponerla; el nivel superior del curso si falta

update_grade_category

Actualizar una categoría de calificación

Cambia una categoría de calificación de get_gradebook_setup: su nombre, su agregación, su peso en su categoría padre (porcentaje, que sustituye al automático) o moverla a otra categoría. La devuelve tras el cambio. Cambia cómo se calculan las calificaciones: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
categoryId	✅	entero
name		texto
aggregation		mean, median, lowest, highest, mode, weighted-mean, simple-weighted-mean, mean-with-extra-credits, natural
weight		número	Porcentaje
parentId		entero	La categoría a la que moverla

delete_grade_category

Eliminar una categoría de calificación

Elimina una categoría de calificación: Moodle mueve lo que contenía a su categoría padre y elimina las calificaciones de su total; la categoría propia del curso no se puede eliminar. No se puede deshacer: confírmalo antes con la persona. El servidor pide antes la confirmación de la persona en su aplicación (elicitation MCP); si dice que no, no pasa nada.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
categoryId	✅	entero

import_grades

Importar calificaciones desde un archivo CSV

Importa calificaciones al calificador de un curso desde un archivo CSV local, como la importación CSV de Moodle: mapFrom es la columna que identifica a cada persona y mapTo lo que contiene (id de usuario, nombre de usuario, número de ID o correo); items dice en qué elemento de calificación (un id de get_gradebook_setup) va cada otra columna, y feedback, de qué elemento es la retroalimentación. preview: true solo muestra cómo lee Moodle el archivo, sin importar nada: hazlo primero. Moodle importa todo o nada. El archivo identifica a las personas: solo con los nombres visibles (el nivel de datos de estudiantes del servidor). Cambia calificaciones que ven los estudiantes: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
file	✅	texto	Una ruta local absoluta al CSV
mapFrom	✅	texto	La columna (su cabecera) que identifica a cada persona
mapTo	✅	id, username, idnumber, email
items		objeto	Cabecera de columna → id del elemento de calificación
feedback		objeto	Cabecera de columna → el elemento de calificación del que es la retroalimentación
preview		sí o no	Solo mostrar cómo lee Moodle el archivo
separator		comma, semicolon, tab, colon
encoding		texto	Una de las que ofrece Moodle; UTF-8 por defecto

list_scales

Listar las escalas de un curso

Lista las escalas que pueden usar las calificaciones de un curso: las suyas y las estándar del sitio, con sus valores y si algo califica con ellas.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero

add_scale

Añadir una escala a un curso

Añade una escala a un curso: su nombre y sus valores de menor a mayor (sin comas), y una descripción. Devuelve la escala. Cambia el curso: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
name	✅	texto
items	✅	lista de texto
description		texto

edit_scale

Cambiar una escala de un curso

Cambia una escala de un curso: su nombre, sus valores o su descripción. Una escala con la que algo califica conserva sus valores. Devuelve la escala. Confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
scaleId	✅	entero	Tal como lo da list_scales
name		texto
items		lista de texto
description		texto

get_grade_letters

Leer las letras de calificación de un curso

Lee las letras de calificación de un curso, del límite más alto al más bajo: las suyas cuando están personalizadas, las del sitio por defecto en otro caso.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero

set_grade_letters

Fijar las letras de calificación de un curso

Fija letras de calificación propias de un curso, cada una desde su porcentaje minGrade, en lugar de las del sitio; useDefaults vuelve a las del sitio. Cambia cómo ven las notas los estudiantes: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
letters		lista de objeto
useDefaults		sí o no	Las letras del sitio por defecto en su lugar

get_completion_report

Obtener la finalización de actividades de un curso

Lee el informe de progreso de un curso: la finalización de cada participante (un alias cuando el servidor seudonimiza) en cada actividad que la registra, de un solo grupo si se indica; si es manual o automática, y si un profesor la ha anulado.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
group		entero	Solo los miembros de este grupo, por su id de list_groups

override_completion

Establecer la finalización de una actividad de un participante

Establece la finalización de una actividad de un participante como hace un profesor desde el informe de progreso (una anulación, que se muestra como tal). Toma al participante tal como lo da get_completion_report. Devuelve el estado guardado. Cambia el progreso del participante: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
activityId	✅	entero	El id de la actividad (id del módulo del curso)
user		texto	El alias del participante, tal como lo dan las herramientas de lectura cuando el servidor seudonimiza
userId		entero	El id de usuario del participante, cuando el servidor muestra los nombres
state	✅	incomplete, complete, complete-pass, complete-fail

get_course_completion_criteria

Leer los criterios de finalización de un curso

Lee qué completa un curso, desde sus ajustes de «Finalización del curso»: actividades, otros cursos, una fecha, días de matrícula, la baja, una calificación del curso, la autofinalización, los roles que la marcan, cómo se combinan, qué ofrece el formulario, si la finalización está activa y si los criterios están bloqueados. Es la finalización del curso, no la de las actividades (get_completion_report).

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero

set_course_completion_criteria

Fijar qué completa un curso

Fija los criterios de finalización de un curso: un criterio dado sustituye los ajustes de ese tipo, uno en remove se quita y uno que no se da se queda; overall dice si completan el curso todos los criterios o cualquiera. Las actividades necesitan seguimiento de finalización, y los roles, permiso para marcar la finalización (offered de get_course_completion_criteria lista ambos). En cuanto alguien cumple un criterio, Moodle los bloquea: unlock borra antes los datos de finalización del curso de todos los participantes (no la finalización de sus actividades). Devuelve los criterios. Confírmalo antes con la persona, y dos veces con unlock. El servidor pide antes la confirmación de la persona en su aplicación (elicitation MCP); si dice que no, no pasa nada.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
overall		all, any
activities		objeto
courses		objeto
date		texto	Completar en este día
enrolmentDays		entero	1 a 30, 40 a 180 de diez en diez, o 365
unenrolment		sí o no
grade		número	En puntos del total del curso
self		sí o no
roles		objeto
remove		lista de activities, courses, date, enrolmentDays, grade, roles	Criterios que quitar
unlock		sí o no	Desbloquear antes los criterios bloqueados, borrando los datos de finalización del curso de todos

get_course_completion_status

Leer quién ha completado un curso

Lee la finalización del curso de cada participante desde el informe de finalización del curso: si lo ha completado y cuándo, y cada criterio cumplido y cuándo; los participantes como alias cuando el servidor seudonimiza. Algunos criterios (una calificación, una fecha, días de matrícula) los calculan las tareas programadas de Moodle, así que un criterio recién cumplido puede no aparecer todavía. Una página cada vez: limit participantes (50 por defecto) tras saltar offset; more dice si hay más.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
user		texto	El alias del participante, tal como lo dan las herramientas de lectura cuando el servidor seudonimiza
userId		entero	El id de usuario del participante, cuando el servidor muestra los nombres
groupId		entero	Solo los participantes de este grupo
limit		entero	Cuántos participantes (50 por defecto, hasta 200)
offset		entero	Cuántos participantes saltar antes (0 por defecto)

mark_course_complete

Marcar la finalización del curso de un participante

Marca a mano la finalización del curso de un participante (un alias cuando el servidor seudonimiza), como el enlace del informe de finalización del curso: el criterio «Finalización manual por otros» del curso para un rol que tiene la persona. Moodle completa el curso cuando el resto de criterios lo permiten. Devuelve su finalización. Confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
user		texto	El alias del participante, tal como lo dan las herramientas de lectura cuando el servidor seudonimiza
userId		entero	El id de usuario del participante, cuando el servidor muestra los nombres

Insignias

Herramienta	Descripción	Solo lectura	Profesor	Alumno
list_badges	Listar las insignias de un curso	✓	✓	✓
create_badge	Crear una insignia del curso		✓
set_badge_criteria	Fijar qué otorga una insignia		✓
set_badge_enabled	Activar o desactivar una insignia		✓
award_badge	Conceder una insignia a mano		✓

list_badges

Listar las insignias de un curso

Lista las insignias de un curso: nombre, descripción, imagen, qué la otorga (el resumen de Moodle), si está activada y si la persona la tiene; para un profesor, también las desactivadas y cuántas personas tiene cada una. Falla con un error claro donde el sitio tiene las insignias desactivadas.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero

create_badge

Crear una insignia del curso

Crea una insignia del curso, desactivada y sin criterios, mediante el formulario de nueva insignia de Moodle: su nombre, su descripción (texto plano) y su imagen (un PNG, JPEG o GIF local, de 256 KB como mucho). Después set_badge_criteria le da criterios y set_badge_enabled la pone a disposición. Devuelve la insignia. Cambia el curso: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
name	✅	texto
description	✅	texto	Texto plano: Moodle quita las etiquetas
image	✅	texto	Una ruta local absoluta a su imagen: PNG, JPEG o GIF, de 256 KB como mucho
imageCaption		texto	El texto alternativo de la imagen

set_badge_criteria

Fijar qué otorga una insignia

Fija los criterios de una insignia: completar actividades (con seguimiento de finalización; todas o cualquiera), completar el curso (con una calificación mínima del curso y una fecha), o concedida a mano por personas con ciertos roles (cualquiera de ellas por defecto); all dice si hay que cumplir todos los criterios o cualquiera. Un criterio dado sustituye los ajustes de ese tipo, uno en remove se quita, y uno que no se da se queda. Moodle solo deja cambiar los criterios mientras la insignia está desactivada y nadie la tiene. Devuelve los criterios. Cambia el curso: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
badgeId	✅	entero	El id de la insignia, tal como lo da list_badges
activities		objeto
courseCompletion		objeto
manual		objeto
all		sí o no	Con más de un criterio: hay que cumplirlos todos, o cualquiera
remove		lista de activities, courseCompletion, manual	Criterios que quitar

set_badge_enabled

Activar o desactivar una insignia

Pone una insignia a disposición de los usuarios, o la retira. Al activarla se concede en el acto a todos los que ya cumplen sus criterios, y se les avisa: confírmalo antes con la persona. Necesita criterios antes. Devuelve la insignia.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
badgeId	✅	entero	El id de la insignia, tal como lo da list_badges
enabled	✅	sí o no

award_badge

Conceder una insignia a mano

Concede a mano una insignia a un participante (un alias cuando el servidor seudonimiza), como uno de los roles que nombra su criterio manual (roleId cuando la persona tiene varios). La insignia tiene que estar activada y tener un criterio manual. Moodle la emite en el acto cuando basta con la concesión manual; si no, cuando se cumple el resto de sus criterios. Se avisa al participante: confírmalo antes con la persona. Devuelve la insignia.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
badgeId	✅	entero	El id de la insignia, tal como lo da list_badges
user		texto	El alias del participante, tal como lo dan las herramientas de lectura cuando el servidor seudonimiza
userId		entero	El id de usuario del participante, cuando el servidor muestra los nombres
roleId		entero	El rol con el que concederla

Herramientas avanzadas (MOODLE_MCP_ADVANCED)

Están desactivadas por defecto, por ser de áreas que usa poca gente: MOODLE_MCP_ADVANCED=true las activa, y los demás límites siguen aplicándose. Consulta Limitar al agente.

Herramienta	Descripción	Solo lectura	Profesor	Alumno
list_course_blocks	Listar los bloques de la página de un curso	✓	✓
add_block	Añadir un bloque a la página de un curso		✓
configure_block	Configurar un bloque de la página de un curso		✓
move_block	Mover un bloque de la página de un curso		✓
delete_block	Eliminar un bloque de la página de un curso		✓
list_content_bank	Listar el banco de contenido de un curso	✓	✓
upload_to_content_bank	Subir contenido H5P al banco de contenido de un curso		✓
rename_content	Renombrar un contenido del banco de contenido		✓
download_content	Descargar un contenido del banco de contenido		✓
delete_content	Eliminar un contenido del banco de contenido		✓
get_bigbluebutton	Leer una actividad BigBlueButton	✓	✓	✓
get_bigbluebutton_join_url	Obtener el enlace para entrar a una reunión BigBlueButton	✓	✓	✓
set_recording_published	Publicar u ocultar una grabación de BigBlueButton		✓
delete_recording	Eliminar una grabación de BigBlueButton		✓
list_notes	Leer las notas sobre los participantes de un curso	✓	✓
add_note	Escribir una nota sobre un participante		✓
edit_note	Cambiar una nota sobre un participante		✓
delete_note	Eliminar una nota sobre un participante		✓
list_competency_frameworks	Listar los marcos de competencias que puede usar un curso	✓	✓
list_course_competencies	Listar las competencias de un curso	✓	✓
add_course_competency	Añadir una competencia a un curso		✓
remove_course_competency	Quitar una competencia de un curso		✓
set_activity_competencies	Vincular competencias a una actividad		✓
get_competency_rating	Leer la valoración de un participante en una competencia	✓	✓	✓
rate_competency	Valorar a un participante en una competencia		✓
list_external_tools	Listar las herramientas externas de un curso	✓	✓
add_external_tool	Añadir una herramienta externa a un curso		✓
set_external_tool_in_chooser	Mostrar una herramienta externa en el selector de actividades		✓
delete_external_tool	Eliminar una herramienta externa de un curso		✓
get_external_tool_launch_url	Obtener el enlace que lanza una actividad LTI	✓	✓	✓

list_course_blocks

Listar los bloques de la página de un curso

Lista los bloques de la página de un curso: tipo, título, región, orden y visibilidad, y el contenido de un bloque de texto.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero

add_block

Añadir un bloque a la página de un curso

Añade un bloque a la página de un curso: un bloque de texto (type html) con su título y su contenido HTML (con imágenes locales incrustadas), u otro bloque del núcleo por su tipo (calendar_upcoming, recent_activity…), en una región o en la predeterminada de la página. Devuelve el bloque. Lo ve todo el curso: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
type	✅	texto	html para un bloque de texto, o el nombre del plugin de otro bloque
region		texto
title		texto
content		texto	El HTML de un bloque de texto
embed		lista de texto	Archivos locales absolutos que nombra el contenido, que van en él: <img src="shot.png">

configure_block

Configurar un bloque de la página de un curso

Cambia un bloque: el título y el contenido de un bloque de texto, o cualquier campo de su formulario de configuración por nombre en settings (bui_visible, config_…). Devuelve el bloque. Confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
blockId	✅	entero	El id del bloque, tal como lo da list_course_blocks
title		texto
content		texto
embed		lista de texto	Archivos locales absolutos que nombra el contenido, que van en él: <img src="shot.png">
settings		objeto	Otros campos del formulario de configuración del bloque, por nombre

move_block

Mover un bloque de la página de un curso

Mueve un bloque a otra región o a otro sitio dentro de ella (weight: el menor va primero). Devuelve el bloque. Confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
blockId	✅	entero	El id del bloque, tal como lo da list_course_blocks
region		texto
weight		entero

delete_block

Eliminar un bloque de la página de un curso

Elimina un bloque de la página de un curso, con su configuración. No se puede deshacer: confírmalo antes con la persona. El servidor pide antes la confirmación de la persona en su aplicación (elicitation MCP); si dice que no, no pasa nada.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
blockId	✅	entero	El id del bloque, tal como lo da list_course_blocks

list_content_bank

Listar el banco de contenido de un curso

Lista el banco de contenido de un curso: el nombre de cada contenido, su biblioteca H5P, autor, fecha, tamaño, cuántas actividades lo usan y si está oculto en la lista.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero

upload_to_content_bank

Subir contenido H5P al banco de contenido de un curso

Sube un archivo .h5p local al banco de contenido de un curso, donde pueden usarlo las actividades H5P. Devuelve el contenido. Cambia el curso: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
file	✅	texto	Una ruta local absoluta al archivo .h5p

rename_content

Renombrar un contenido del banco de contenido

Renombra un contenido de un banco de contenido. Confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
contentId	✅	entero	El id del contenido, tal como lo da list_content_bank
name	✅	texto

download_content

Descargar un contenido del banco de contenido

Guarda un contenido del banco de contenido (su archivo .h5p) en una carpeta local.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
contentId	✅	entero	El id del contenido, tal como lo da list_content_bank
destDir	✅	texto	Una carpeta local absoluta

delete_content

Eliminar un contenido del banco de contenido

Elimina un contenido de un banco de contenido. No se puede deshacer: confírmalo antes con la persona. El servidor pide antes la confirmación de la persona en su aplicación (elicitation MCP); si dice que no, no pasa nada.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
contentId	✅	entero	El id del contenido, tal como lo da list_content_bank

get_bigbluebutton

Leer una actividad BigBlueButton

Lee una actividad BigBlueButton: si aún no está abierta, abierta, en curso o cerrada, su horario, cuántos hay dentro mientras está en curso, si la persona puede entrar y como moderadora, y sus grabaciones (todas para quien las gestiona, las publicadas para los demás). Falla con un error claro donde el servidor BigBlueButton del sitio no está configurado.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
activityId	✅	entero	El id de la actividad BigBlueButton (id del módulo del curso), tal como lo da get_course_structure

get_bigbluebutton_join_url

Obtener el enlace para entrar a una reunión BigBlueButton

Da el enlace con el que la persona entra a una reunión BigBlueButton, para que lo abra ella; aquí no se entra a nada. El enlace es de la propia persona: dáselo a ella y a nadie más.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
activityId	✅	entero	El id de la actividad BigBlueButton (id del módulo del curso), tal como lo da get_course_structure

set_recording_published

Publicar u ocultar una grabación de BigBlueButton

Publica una grabación de BigBlueButton para los estudiantes, o se la oculta. Devuelve la grabación. Confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
activityId	✅	entero	El id de la actividad BigBlueButton (id del módulo del curso), tal como lo da get_course_structure
recordingId	✅	entero	El id de la grabación, tal como lo da get_bigbluebutton
published	✅	sí o no

delete_recording

Eliminar una grabación de BigBlueButton

Elimina una grabación de BigBlueButton. No se puede deshacer: confírmalo antes con la persona. El servidor pide antes la confirmación de la persona en su aplicación (elicitation MCP); si dice que no, no pasa nada.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
activityId	✅	entero	El id de la actividad BigBlueButton (id del módulo del curso), tal como lo da get_course_structure
recordingId	✅	entero	El id de la grabación, tal como lo da get_bigbluebutton

list_notes

Leer las notas sobre los participantes de un curso

Lee las notas sobre los participantes de un curso, o sobre uno: sobre quién es y quién la escribió (alias cuando el servidor seudonimiza), su contenido, si es personal, del curso o del sitio, y si la persona puede cambiarla. Una página cada vez: limit notas (50 por defecto) tras saltar offset; more dice si hay más.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
user		texto	El alias del participante, tal como lo dan las herramientas de lectura cuando el servidor seudonimiza
userId		entero	El id de usuario del participante, cuando el servidor muestra los nombres
limit		entero	Cuántas notas (50 por defecto, hasta 200)
offset		entero	Cuántas notas saltar antes (0 por defecto)

add_note

Escribir una nota sobre un participante

Escribe una nota sobre un participante (un alias cuando el servidor seudonimiza): su contenido (HTML, sin alias) y quién la ve. Devuelve la nota. Confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
user		texto	El alias del participante, tal como lo dan las herramientas de lectura cuando el servidor seudonimiza
userId		entero	El id de usuario del participante, cuando el servidor muestra los nombres
content	✅	texto
context		personal, course, site	personal: solo la ve su autor; course: los profesores del curso; site: los profesores de cualquier curso

edit_note

Cambiar una nota sobre un participante

Cambia el contenido de una nota (sin alias) o quién la ve. Devuelve la nota. Confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
noteId	✅	entero	El id de la nota, tal como lo da list_notes
content		texto
context		personal, course, site	personal: solo la ve su autor; course: los profesores del curso; site: los profesores de cualquier curso

delete_note

Eliminar una nota sobre un participante

Elimina una nota. No se puede deshacer: confírmalo antes con la persona. El servidor pide antes la confirmación de la persona en su aplicación (elicitation MCP); si dice que no, no pasa nada.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
noteId	✅	entero	El id de la nota, tal como lo da list_notes

list_competency_frameworks

Listar los marcos de competencias que puede usar un curso

Lista los marcos de competencias de los que un curso puede tomar sus competencias, cada uno con sus competencias (id, nombre corto, número de ID, descripción, madre). Falla con un error claro donde el sitio tiene las competencias desactivadas.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero

list_course_competencies

Listar las competencias de un curso

Lista las competencias de un curso, cada una con su marco y las actividades del curso vinculadas a ella.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero

add_course_competency

Añadir una competencia a un curso

Añade a un curso una competencia de un marco. Devuelve las competencias del curso. Cambia el curso: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
competencyId	✅	entero	El id de la competencia, tal como lo da list_competency_frameworks o list_course_competencies

remove_course_competency

Quitar una competencia de un curso

Quita una competencia de un curso, y sus vínculos con las actividades del curso. Devuelve las competencias del curso. Confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
competencyId	✅	entero	El id de la competencia, tal como lo da list_competency_frameworks o list_course_competencies

set_activity_competencies

Vincular competencias a una actividad

Fija las competencias del curso vinculadas a una actividad: la lista dada sustituye sus vínculos ([] los quita). Devuelve las competencias de la actividad. Confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
activityId	✅	entero	Tal como lo da get_course_structure
competencyIds	✅	lista de entero	Las competencias del curso, tal como las da list_course_competencies

get_competency_rating

Leer la valoración de un participante en una competencia

Lee la valoración de un participante en una competencia del curso (un alias cuando el servidor seudonimiza; la de la propia persona si falta): la valoración, si es competente, la escala, las evidencias en el curso (la más reciente primero) y si la persona puede valorarle.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
competencyId	✅	entero	El id de la competencia, tal como lo da list_competency_frameworks o list_course_competencies
user		texto	El alias del participante, tal como lo dan las herramientas de lectura cuando el servidor seudonimiza
userId		entero	El id de usuario del participante, cuando el servidor muestra los nombres

rate_competency

Valorar a un participante en una competencia

Valora a un participante (un alias cuando el servidor seudonimiza) en una competencia del curso: un valor de su escala (1 el primero) o el nombre del elemento, con una nota que se guarda como evidencia (sin alias). Devuelve la valoración. El participante la ve: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
competencyId	✅	entero	El id de la competencia, tal como lo da list_competency_frameworks o list_course_competencies
user		texto	El alias del participante, tal como lo dan las herramientas de lectura cuando el servidor seudonimiza
userId		entero	El id de usuario del participante, cuando el servidor muestra los nombres
rating	✅	texto	El valor del elemento de la escala ("2") o su nombre
note		texto

list_external_tools

Listar las herramientas externas de un curso

Lista las herramientas externas (LTI) que puede usar un curso: las que un administrador configuró para el sitio y las del propio curso, cada una con si los profesores la encuentran en el selector de actividades. create_activity crea una actividad LTI a partir de una por su id (type lti, toolId).

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero

add_external_tool

Añadir una herramienta externa a un curso

Añade una herramienta externa (LTI 1.0/1.1) a un curso por su URL de lanzamiento, con la clave de consumidor y el secreto compartido que dio su proveedor (Moodle guarda el secreto; nada lo devuelve), y cualquier otro campo del formulario de herramienta del curso por nombre. Devuelve la herramienta. Una herramienta lleva a la gente del curso a otro sitio: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
name	✅	texto
url	✅	texto	La URL de lanzamiento de la herramienta, o la de un cartucho
description		texto
key		texto	La clave de consumidor
secret		texto	El secreto compartido
settings		objeto	Otros campos del formulario de herramienta del curso, por nombre (lti_launchcontainer, lti_sendname…)

set_external_tool_in_chooser

Mostrar una herramienta externa en el selector de actividades

Muestra una herramienta externa del curso en el selector de actividades, o la deja fuera. Devuelve la herramienta. Confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
toolId	✅	entero	El id de la herramienta, tal como lo da list_external_tools
shown	✅	sí o no

delete_external_tool

Eliminar una herramienta externa de un curso

Elimina una de las herramientas externas propias del curso. No se puede deshacer: confírmalo antes con la persona. El servidor pide antes la confirmación de la persona en su aplicación (elicitation MCP); si dice que no, no pasa nada.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
toolId	✅	entero	El id de la herramienta, tal como lo da list_external_tools

get_external_tool_launch_url

Obtener el enlace que lanza una actividad LTI

Da el enlace que lanza una actividad LTI para la persona, para que lo abra ella; aquí no se lanza nada. El enlace es de la propia persona: dáselo a ella y a nadie más.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
activityId	✅	entero	El id de la actividad LTI (id del módulo del curso), tal como lo da get_course_structure

Informes

Herramienta	Descripción	Solo lectura	Profesor	Alumno
get_activity_report	Obtener las visualizaciones de actividades de un curso	✓	✓
get_participation_report	Obtener quién ha participado en una actividad	✓	✓
get_course_logs	Obtener los registros de un curso	✓	✓
get_choice_results	Leer los resultados de una consulta	✓	✓
get_survey_results	Leer los resultados de una encuesta	✓	✓

get_activity_report

Obtener las visualizaciones de actividades de un curso

Lee el informe de actividad de un curso: por actividad, cuántas veces se ha visto, por cuántas personas y cuándo por última vez, a partir de los registros (entre from y until si se indican). Solo recuentos, sin el nombre de nadie. Las actividades que nadie ha visto aparecen con cero.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
from		texto	ISO 8601
until		texto	ISO 8601

get_participation_report

Obtener quién ha participado en una actividad

Lee el informe de participación de una actividad: todas las personas con un rol (todos los roles que ofrece, salvo que se indique roleId) y cuántas acciones han hecho allí (solo visualizaciones o mensajes con action; desde una fecha con since); quienes no han hecho nada aparecen con 0. Las personas como alias cuando el servidor seudonimiza.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
activityId	✅	entero
roleId		entero
since		texto	ISO 8601
action		view, post

get_course_logs

Obtener los registros de un curso

Lee los registros de un curso, los más recientes primero, tal como los lista su informe de registros: por un usuario (un alias cuando el servidor seudonimiza), una actividad, un tipo de acción y un intervalo de tiempo, una página cada vez: limit entradas (50 por defecto) tras saltar offset; more indica si hay más. Cada entrada: cuándo, quién, sobre quién, dónde, qué ocurrió (la descripción más larga de Moodle solo con includeDescriptions). Nunca direcciones IP.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
user		texto	El alias del participante, tal como lo dan las herramientas de lectura cuando el servidor seudonimiza
userId		entero	El id de usuario del participante, cuando el servidor muestra los nombres
activityId		entero
action		create, view, update, delete, change
from		texto	ISO 8601
until		texto	ISO 8601
limit		entero	Cuántas entradas (50 por defecto)
offset		entero	Cuántas entradas saltar primero, las más recientes primero (0 por defecto)
includeDescriptions		sí o no	Incluir también la descripción de cada entrada, la frase de Moodle sobre ella (más largo; false por defecto)

get_choice_results

Leer los resultados de una consulta

Lee las respuestas de una consulta tal como las muestra su informe a un profesor: cada opción con cuántos la eligieron y quiénes (alias cuando el servidor seudonimiza), y quién no ha respondido donde la consulta lo muestra. El informe nombra a las personas sea cual sea lo que la consulta publica para los estudiantes.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
choiceId	✅	entero	El id de la actividad (id del módulo del curso), tal como lo da get_course_structure

get_survey_results

Leer los resultados de una encuesta

Lee lo que respondieron las personas en un feedback o un cuestionario de encuesta, tal como lo muestran sus informes a un profesor: cada respuesta (quién la dio, un alias cuando el servidor seudonimiza, nadie si es anónima) y, por pregunta, la respuesta de cada uno (el texto, redactado al seudonimizar), los recuentos de las opciones de una pregunta de elección y la media de las numéricas y valoradas. Un cuestionario de encuesta solo lista sus respuestas cuando alguien ha respondido.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
activityId	✅	entero	El id de la actividad (id del módulo del curso), tal como lo da get_course_structure
type		questionnaire, feedback	El tipo de la actividad, tal como lo da get_course_structure; se averigua si falta

Participantes y grupos

Herramienta	Descripción	Solo lectura	Profesor	Alumno
list_participants	Listar los participantes de un curso	✓	✓	✓
list_potential_users	Buscar usuarios para matricular	✓	✓
enrol_users	Matricular usuarios en un curso		✓
unenrol_user	Desmatricular a un usuario de un curso		✓
set_user_roles	Establecer los roles de alguien en un curso		✓
list_enrolment_methods	Listar los métodos de matriculación de un curso	✓	✓
set_enrolment_method	Configurar un método de matriculación		✓
list_groups	Listar los grupos de un curso	✓	✓	✓
create_group	Crear un grupo		✓
update_group	Cambiar un grupo		✓
delete_group	Eliminar un grupo		✓
set_group_members	Añadir o quitar miembros de un grupo		✓
list_groupings	Listar los agrupamientos de un curso	✓	✓
create_grouping	Crear un agrupamiento		✓
delete_grouping	Eliminar un agrupamiento		✓
set_grouping_groups	Establecer los grupos de un agrupamiento		✓
auto_create_groups	Crear grupos automáticamente		✓
import_groups	Importar grupos desde un archivo CSV		✓

list_participants

Listar los participantes de un curso

Lista los participantes de un curso con sus roles y grupos, como hace la página de participantes: las personas como alias cuando el servidor seudonimiza, nunca correos electrónicos ni campos del perfil. Filtra por rol, grupo, o quienes no han accedido al curso desde una fecha (inactiveSince). Por páginas: limit participantes (50 por defecto) tras saltarse offset; more dice si hay más.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
role		entero	Solo los de este rol, por su id (tal como lo dan los roles de los participantes)
group		entero	Solo los miembros de este grupo, por su id de list_groups
inactiveSince		texto	Solo quienes no han accedido al curso desde esta fecha (ISO 8601)
limit		entero	Cuántos participantes (50 por defecto, hasta 500)
offset		entero	Cuántos participantes saltarse primero (0 por defecto)

list_potential_users

Buscar usuarios para matricular

Busca usuarios que la persona puede matricular en un curso mediante matriculación manual, como hace el diálogo "Matricular usuarios": los que coinciden con search en su nombre o en los campos de identidad que muestra el sitio (hasta 100 si está vacío). Las personas como alias cuando el servidor seudonimiza, nunca sus correos electrónicos. Matricúlalos con enrol_users.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
search		texto	Parte de un nombre, un correo electrónico, un número de ID…

enrol_users

Matricular usuarios en un curso

Matricula usuarios en un curso mediante matriculación manual, como hace el diálogo "Matricular usuarios": con un rol (el predeterminado de la matriculación salvo que se indique roleId), desde start (ahora) hasta end (la duración predeterminada de la matriculación). Los toma tal como los da list_potential_users. Quienes ya están matriculados conservan su matriculación, con las nuevas fechas. Confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
users		lista de texto	Los alias de los participantes, tal como los dan las herramientas de lectura cuando el servidor seudonimiza
userIds		lista de entero	Los ids de usuario de los participantes, cuando el servidor muestra los nombres
roleId		entero	El rol que se asigna, tal como lo dan los roles de list_participants
start		texto	ISO 8601
end		texto	ISO 8601

unenrol_user

Desmatricular a un usuario de un curso

Desmatricula a alguien de un curso: elimina todas sus matriculaciones que la persona puede eliminar, junto con sus roles y su pertenencia a grupos en el curso; removed y kept nombran los métodos de matriculación. Su trabajo en el curso se queda en Moodle, pero pierde el acceso. Confírmalo antes con la persona. El servidor pide antes la confirmación de la persona en su aplicación (elicitation MCP); si dice que no, no pasa nada.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
user		texto	El alias del participante, tal como lo dan las herramientas de lectura cuando el servidor seudonimiza
userId		entero	El id de usuario del participante, cuando el servidor muestra los nombres

set_user_roles

Establecer los roles de alguien en un curso

Establece los roles de un participante en un curso, como hace la columna de roles de la página de participantes: asigna los roles de roleIds que la persona puede asignar y quita los demás que puede asignar; los roles de otros contextos se mantienen. Devuelve los roles resultantes. Confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
user		texto	El alias del participante, tal como lo dan las herramientas de lectura cuando el servidor seudonimiza
userId		entero	El id de usuario del participante, cuando el servidor muestra los nombres
roleIds	✅	lista de entero	Ids de rol, tal como los dan los roles de list_participants

list_enrolment_methods

Listar los métodos de matriculación de un curso

Lista cómo puede matricularse la gente en un curso, en el orden en que Moodle los prueba: el tipo de cada método, su nombre, si está activado, cuántas personas ha matriculado, el rol que asigna y, para la automatriculación y el acceso de invitados, si pide una clave (nunca la clave), fechas y límite.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero

set_enrolment_method

Configurar un método de matriculación

Cambia un método de matriculación con su formulario, por su id o el primero de un tipo en el curso (methodType "self": se añade cuando el curso no tiene ninguno y Moodle lo ofrece): activarlo o desactivarlo, su clave, fechas, rol, límite y mensaje de bienvenida. Solo cambia lo que se indica. Devuelve el método resultante (nunca la clave). Abre o cierra el curso a la gente: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
methodId		entero	Tal como lo da list_enrolment_methods
methodType		texto	O el tipo del método, como "self" o "guest"
enabled		sí o no
key		texto	Clave de automatriculación o de acceso de invitados; vacía para quitarla
start		texto	Desde cuándo, ISO 8601; "none" para quitarlo
end		texto	Hasta cuándo, ISO 8601; "none" para quitarlo
roleId		entero
maxUsers		entero	0 para no tener límite
welcomeMessage		texto	Automatriculación: enviar este mensaje de bienvenida
noWelcome		sí o no	Automatriculación: no enviar mensaje de bienvenida

list_groups

Listar los grupos de un curso

Lista los grupos de un curso que la persona puede ver, con sus miembros (como alias cuando el servidor seudonimiza). Sus ids son lo que admite el filtro de grupo de los informes.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero

create_group

Crear un grupo

Crea un grupo en un curso con el formulario de grupos de Moodle. Añade sus miembros con set_group_members. Devuelve su id. Cambia el curso: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
name	✅	texto
description		texto	HTML
idNumber		texto	Un id para sistemas externos
enrolmentKey		texto	Una clave que matricula a los estudiantes directamente en este grupo con la automatriculación

update_group

Cambiar un grupo

Cambia el nombre, la descripción, el número de ID o la clave de matriculación de un grupo; lo que no se indica se mantiene. Confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
groupId	✅	entero	El id del grupo, tal como lo da list_groups
name		texto
description		texto	HTML
idNumber		texto	Un id para sistemas externos
enrolmentKey		texto	Una clave que matricula a los estudiantes directamente en este grupo con la automatriculación

delete_group

Eliminar un grupo

Elimina un grupo; sus miembros siguen en el curso. Las actividades configuradas para trabajar por grupos lo pierden. No se puede deshacer: confírmalo antes con la persona. El servidor pide antes la confirmación de la persona en su aplicación (elicitation MCP); si dice que no, no pasa nada.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
groupId	✅	entero	El id del grupo, tal como lo da list_groups

set_group_members

Añadir o quitar miembros de un grupo

Añade y quita miembros de un grupo, como hace su página de miembros: solo se pueden añadir participantes del curso. Los toma tal como los da list_participants: alias (add, remove) cuando el servidor seudonimiza, si no, ids de usuario (addIds, removeIds). Devuelve los miembros resultantes. Confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero	El curso del grupo
groupId	✅	entero	Tal como lo da list_groups
add		lista de texto	Alias que añadir, cuando el servidor seudonimiza
remove		lista de texto	Alias que quitar, cuando el servidor seudonimiza
addIds		lista de entero	Ids de usuario que añadir, cuando el servidor muestra los nombres
removeIds		lista de entero	Ids de usuario que quitar, cuando el servidor muestra los nombres

list_groupings

Listar los agrupamientos de un curso

Lista los agrupamientos de un curso (conjuntos de grupos a los que se puede limitar una actividad) con los ids de sus grupos. Requiere el permiso para gestionar grupos.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero

create_grouping

Crear un agrupamiento

Crea un agrupamiento en un curso con el formulario de Moodle; asígnale sus grupos con set_grouping_groups. Devuelve su id. Confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
name	✅	texto
description		texto	HTML
idNumber		texto

delete_grouping

Eliminar un agrupamiento

Elimina un agrupamiento; sus grupos se mantienen. No se puede deshacer: confírmalo antes con la persona. El servidor pide antes la confirmación de la persona en su aplicación (elicitation MCP); si dice que no, no pasa nada.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
groupingId	✅	entero	El id del agrupamiento, tal como lo da list_groupings

set_grouping_groups

Establecer los grupos de un agrupamiento

Hace que los grupos de un agrupamiento sean exactamente groupIds, añadiendo y quitando como hace su página; los grupos de otros cursos se dejan fuera y se nombran. Devuelve sus grupos resultantes. Confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
groupingId	✅	entero	El id del agrupamiento, tal como lo da list_groupings
groupIds	✅	lista de entero

auto_create_groups

Crear grupos automáticamente

Reparte a los participantes de un curso en grupos de una vez, como «Crear grupos automáticamente» de Moodle: count grupos, o grupos de count miembros, con el nombre de naming (# un número, @ una letra), llenados al azar o por nombre o número de ID (o vacíos), a partir de un rol (estudiantes por defecto), una cohorte, una agrupación o un grupo, y opcionalmente en una agrupación existente o nueva. preview: true muestra los grupos y miembros que haría Moodle sin crear nada: hazlo primero y luego devuelve su seed para crear esos mismos grupos. Los miembros como alias cuando el servidor seudonimiza. Confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
by	✅	groups, members	groups: count grupos; members: grupos de count miembros
count	✅	entero
naming	✅	texto	Los nombres de los grupos: # pasa a ser su número y @ una letra ("Grupo @")
allocation		random, firstname, lastname, idnumber, none	random por defecto; none los deja vacíos
roleId		entero	Solo este rol (0: todos los roles); estudiantes por defecto
cohortId		entero
fromGroupingId		entero
fromGroupId		entero
notInGroup		sí o no	Solo participantes que aún no están en ningún grupo
noSmallGroups		sí o no	Con members: repartir entre los demás un último grupo demasiado pequeño
groupingId		entero	Ponerlos en esta agrupación
newGrouping		texto	O en una agrupación nueva con este nombre
preview		sí o no
seed		entero	La seed de una vista previa, para crear esos mismos grupos

import_groups

Importar grupos desde un archivo CSV

Crea grupos desde un archivo CSV local, como «Importar grupos» de Moodle: una columna groupname, y opcionalmente description, enrolmentkey, groupidnumber, groupingname (se crea si falta) y enablemessaging. Moodle crea los grupos sin miembros. Devuelve los grupos nuevos y los mensajes de Moodle sobre las filas que se saltó. Cambia el curso: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
file	✅	texto	Una ruta local absoluta al CSV
delimiter		comma, semicolon, colon, tab

Foros, talleres y mensajes

Herramienta	Descripción	Solo lectura	Profesor	Alumno
list_discussions	Listar los debates de un foro	✓	✓	✓
get_discussion	Leer un debate de un foro	✓	✓	✓
reply_to_post	Responder a un mensaje del foro		✓	✓
create_discussion	Iniciar un debate en un foro		✓	✓
edit_post	Editar un mensaje del foro		✓	✓
delete_post	Eliminar un mensaje del foro		✓	✓
set_discussion_state	Fijar o bloquear un debate		✓
set_discussion_subscription	Suscribirse a un debate de un foro		✓	✓
get_forum_grades	Obtener las calificaciones globales de un foro	✓	✓
grade_forum_user	Poner una calificación global del foro		✓
rate	Valorar un mensaje, entrada o registro		✓	✓
get_workshop	Leer un taller	✓	✓
set_workshop_phase	Cambiar la fase de un taller		✓
assess_workshop_submission	Evaluar una entrega de un taller		✓	✓
get_workshop_submission	Leer una entrega de un taller	✓	✓	✓
save_workshop_submission	Entregar en un taller		✓	✓
list_workshop_examples	Listar las entregas de ejemplo de un taller	✓	✓
add_workshop_example	Añadir una entrega de ejemplo a un taller		✓
edit_workshop_example	Cambiar una entrega de ejemplo de un taller		✓
delete_workshop_example	Eliminar una entrega de ejemplo de un taller		✓
assess_workshop_example	Evaluar una entrega de ejemplo de un taller		✓	✓
calculate_workshop_grades	Calcular las calificaciones de un taller		✓
override_workshop_grade	Modificar a mano una calificación de un taller		✓
get_workshop_allocation	Leer quién evalúa a quién en un taller	✓	✓
allocate_workshop_reviewer	Asignar un revisor a una entrega de un taller		✓
remove_workshop_reviewer	Quitar un revisor de una entrega de un taller		✓
allocate_workshop_randomly	Asignar al azar los revisores de un taller		✓
schedule_workshop_allocation	Programar la asignación aleatoria de un taller		✓
list_notifications	Listar mis notificaciones	✓	✓	✓
mark_notifications_read	Marcar mis notificaciones como leídas		✓	✓
list_conversations	Listar mis conversaciones	✓	✓	✓
get_conversation	Leer una conversación	✓	✓	✓
send_message	Enviar un mensaje privado		✓	✓
message_participants	Enviar un mensaje a varios participantes		✓

list_discussions

Listar los debates de un foro

Lista los debates de un foro de Moodle: asunto, quién lo inició y cuándo, el autor y la hora del último mensaje, el número de respuestas (0: sin responder) y si está bloqueado. Por páginas: limit debates (30 por defecto) tras saltarse offset; more dice si hay más. Toma el id del foro de get_course_structure; lee uno con get_discussion.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
forumId	✅	entero	El id del foro (su id de módulo del curso), tal como lo da get_course_structure
limit		entero	Cuántos debates (30 por defecto, hasta 100)
offset		entero	Cuántos debates saltarse primero, en el orden del foro (0 por defecto)

get_discussion

Leer un debate de un foro

Lee los mensajes de un debate de un foro de Moodle, los más antiguos primero, por páginas (limit mensajes, 50 por defecto, tras saltarse offset; more dice si hay más): autor (un alias cuando el servidor seudonimiza), hora, el mensaje al que responde, el mensaje como texto plano (con nombres y datos de contacto ocultos al seudonimizar) y los adjuntos. Toma el id del debate de list_discussions.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
discussionId	✅	entero	El id del debate, tal como lo da list_discussions
limit		entero	Cuántos mensajes (50 por defecto, hasta 200)
offset		entero	Cuántos mensajes saltarse primero, los más antiguos primero (0 por defecto)

reply_to_post

Responder a un mensaje del foro

Responde a un mensaje en un debate de un foro de Moodle, con adjuntos opcionales (archivos locales). El asunto por defecto es el "Re: …" de Moodle. Devuelve el id del nuevo mensaje y su debate. Publica como la persona, de forma visible: confirma antes el texto con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
postId	✅	entero	El mensaje al que responder, tal como lo da get_discussion
subject		texto
message	✅	texto	El mensaje (HTML); sin alias, ya que lo leen otras personas
files		lista de texto	Rutas locales absolutas que adjuntar
embed		lista de texto	Archivos locales absolutos (imágenes…) que incrustar en el HTML, que nombra cada uno por su nombre de archivo: <img src="shot.png">
subscribe		sí o no	Suscribirse al debate; lo predeterminado de Moodle si falta
fields		objeto	Otros campos del formulario del mensaje por nombre, p. ej., {"pinned": true} para un profesor

create_discussion

Iniciar un debate en un foro

Inicia un debate en un foro de Moodle, con adjuntos e imágenes incrustadas opcionales (archivos locales); un profesor puede publicar avisos así en el foro de avisos. Devuelve el id del nuevo debate y, leídos de vuelta, si está fijado y si la persona está suscrita. Publica como la persona, de forma visible: confirma antes el texto con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
forumId	✅	entero	El id del foro (id del módulo del curso), tal como lo da get_course_structure
subject	✅	texto
message	✅	texto	El mensaje (HTML); sin alias, ya que lo leen otras personas
files		lista de texto	Rutas locales absolutas que adjuntar
embed		lista de texto	Archivos locales absolutos (imágenes…) que incrustar en el HTML, que nombra cada uno por su nombre de archivo: <img src="shot.png">
subscribe		sí o no	Suscribirse al debate; lo predeterminado de Moodle si falta
fields		objeto	Otros campos del formulario del mensaje por nombre, p. ej., {"pinned": true} para un profesor

edit_post

Editar un mensaje del foro

Cambia un mensaje del foro mediante el propio formulario de Moodle, como su autor (dentro del tiempo de edición del sitio) o como moderador: su asunto, su mensaje (HTML) y adjuntos que añadir o quitar. Solo cambia lo que se indica. Devuelve el mensaje después (su autor como alias cuando el servidor seudonimiza). Visible para el foro: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
postId	✅	entero	Tal como lo da get_discussion
subject		texto
message		texto	HTML; sin alias, ya que lo leen otras personas
addFiles		lista de texto	Rutas locales absolutas que adjuntar
removeFiles		lista de texto	Nombres de los adjuntos que quitar
embed		lista de texto	Archivos locales absolutos (imágenes…) que incrustar en el HTML, que nombra cada uno por su nombre de archivo: <img src="shot.png">

delete_post

Eliminar un mensaje del foro

Elimina un mensaje del foro y sus respuestas mediante la propia confirmación de Moodle; el primer mensaje de un debate se lleva el debate entero. Solo un moderador elimina el mensaje de otra persona o uno con respuestas. No se puede deshacer: confírmalo antes con la persona. El servidor pide antes la confirmación de la persona en su aplicación (elicitation MCP); si dice que no, no pasa nada.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
postId	✅	entero	Tal como lo da get_discussion

set_discussion_state

Fijar o bloquear un debate

Fija o desfija, bloquea o desbloquea un debate de un foro, como hace el menú de la lista de debates; lo que ya está así no se toca. Devuelve el debate tal como lo lista el foro después. Los estudiantes lo ven: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
forumId	✅	entero	El id del foro (id del módulo del curso), tal como lo da get_course_structure
discussionId	✅	entero	Tal como lo da list_discussions
pinned		sí o no
locked		sí o no

set_discussion_subscription

Suscribirse a un debate de un foro

Suscribe a la persona a un debate de un foro, o la da de baja, como hace el interruptor de la lista de debates: Moodle le envía entonces por correo electrónico sus nuevos mensajes. Lo que ya está así no se toca. Devuelve el debate tal como lo lista el foro después.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
forumId	✅	entero	El id del foro (id del módulo del curso), tal como lo da get_course_structure
discussionId	✅	entero	Tal como lo da list_discussions
subscribed	✅	sí o no

get_forum_grades

Obtener las calificaciones globales de un foro

Lee las calificaciones globales de un foro que se califica en su conjunto, tal como las muestra su calificador: una por cada persona que puede calificar (alias cuando el servidor seudonimiza), con cómo se califica (puntos o escala) y quién calificó.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
forumId	✅	entero	El id del foro (id del módulo del curso)
groupId		entero

grade_forum_user

Poner una calificación global del foro

Pone a un participante su calificación global del foro, como hace el calificador del foro: puntos ("7"), un elemento de la escala, o "none" para quitarla; notify le envía la notificación de Moodle. Los estudiantes pueden verla: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
forumId	✅	entero	El id del foro (id del módulo del curso)
user		texto	El alias del participante, tal como lo dan las herramientas de lectura cuando el servidor seudonimiza
userId		entero	El id de usuario del participante, cuando el servidor muestra los nombres
grade	✅	texto
notify		sí o no

rate

Valorar un mensaje, entrada o registro

Valora un mensaje del foro, una entrada de glosario o un registro de base de datos como la persona, como hace el menú de valoración que tiene debajo: el nombre de un elemento de la escala, o un número (los puntos de una escala de puntos); "none" quita la valoración de la persona. Devuelve después el agregado del elemento. Los estudiantes pueden verlo: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
itemType	✅	forum-post, glossary-entry, database-record
itemId	✅	entero	El id del mensaje, de la entrada o del registro
discussionId		entero	Para un mensaje del foro: su debate
rating	✅	texto

get_workshop

Leer un taller

Lee la fase de un taller y su informe tal como lo ve un profesor: cada entrega (autor, título, calificación una vez calculada) y cada evaluación (revisor, el autor de la entrega, la calificación que da, su peso, la calificación por evaluar). Las personas como alias cuando el servidor seudonimiza. Listas vacías antes de la fase de envío, o para alguien que no puede ver todas las entregas.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
workshopId	✅	entero	El id del taller (id del módulo del curso)

set_workshop_phase

Cambiar la fase de un taller

Cambia un taller a una fase (setup, submission, assessment, evaluation, closed), hacia delante o hacia atrás, como hacen los enlaces de fase de su página. Moodle no asigna nada ni calcula calificaciones por sí solo al cambiar. Cambia lo que pueden hacer los estudiantes: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
workshopId	✅	entero	El id del taller (id del módulo del curso)
phase	✅	setup, submission, assessment, evaluation, closed

assess_workshop_submission

Evaluar una entrega de un taller

Evalúa una entrega de un taller como la persona, mediante el formulario de evaluación del taller (el de su estrategia de calificación): una calificación y un comentario por criterio en el orden del formulario, comentarios de retroalimentación generales para el autor (HTML) y cualquier otro campo por nombre. Una evaluación nueva la primera vez, la misma cambiada después. Solo en la fase de evaluación. Devuelve la calificación que da. El autor la lee: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
workshopId	✅	entero	El id del taller (id del módulo del curso)
submissionId	✅	entero	Tal como lo da get_workshop
criteria		lista de objeto	En el orden del formulario
feedback		texto	Comentarios de retroalimentación generales para el autor (HTML); sin alias
fields		objeto	Cualquier otro campo del formulario, por nombre

get_workshop_submission

Leer una entrega de un taller

Lee una entrega de un taller tal como la muestra su página: título, texto (HTML), archivos adjuntos, autor (un alias cuando el servidor seudonimiza, donde Moodle muestra los autores) y si la persona puede editarla ahora. Sin submissionId ni autor, la de la propia persona (ninguna si no ha entregado); un profesor lee cualquiera, un revisor las que tiene asignadas.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
workshopId	✅	entero	El id del taller (id del módulo del curso)
submissionId		entero	Tal como lo da get_workshop
author		texto	O el alias de su autor, cuando el servidor seudonimiza
authorId		entero	O el id de usuario de su autor, cuando el servidor muestra los nombres

save_workshop_submission

Entregar en un taller

Añade la entrega de la persona a un taller, o cambia la que tiene, con su formulario de entrega: título, texto (HTML, con imágenes locales incrustadas) y archivos locales adjuntos; solo cambia lo que se indica (una nueva necesita título). Moodle la acepta en la fase de envío, dentro de sus fechas. Devuelve la entrega. La leerán los revisores: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
workshopId	✅	entero	El id del taller (id del módulo del curso)
title		texto	Su título; uno nuevo lo necesita
content		texto	Su texto (HTML), donde el taller acepta texto en línea; sin alias
attachments		lista de texto	Rutas locales absolutas: sustituyen a los archivos adjuntos antes
embed		lista de texto	Archivos locales absolutos que incrustar en el texto, que nombra cada uno por su nombre de archivo: <img src="shot.png">

list_workshop_examples

Listar las entregas de ejemplo de un taller

Lista las entregas de ejemplo de un taller tal como las muestra su página a un profesor: título, y si su evaluación de referencia está hecha, con su calificación. Moodle las lista en la fase de configuración, donde el taller usa ejemplos.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
workshopId	✅	entero	El id del taller (id del módulo del curso)

add_workshop_example

Añadir una entrega de ejemplo a un taller

Añade una entrega de ejemplo a un taller, para que los participantes practiquen la evaluación: título, texto (HTML, con imágenes locales incrustadas) y archivos adjuntos. Después assess_workshop_example hace su evaluación de referencia. Solo donde el taller usa ejemplos. Cambia el curso: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
workshopId	✅	entero	El id del taller (id del módulo del curso)
title	✅	texto
content		texto	Su texto (HTML), donde el taller acepta texto en línea; sin alias
attachments		lista de texto	Rutas locales absolutas: sustituyen a los archivos adjuntos antes
embed		lista de texto	Archivos locales absolutos que incrustar en el texto, que nombra cada uno por su nombre de archivo: <img src="shot.png">

edit_workshop_example

Cambiar una entrega de ejemplo de un taller

Cambia una entrega de ejemplo: solo lo que se indica (attachments sustituye los que hay). Cambia el curso: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
workshopId	✅	entero	El id del taller (id del módulo del curso)
exampleId	✅	entero	Tal como lo da list_workshop_examples
title		texto	Su título; uno nuevo lo necesita
content		texto	Su texto (HTML), donde el taller acepta texto en línea; sin alias
attachments		lista de texto	Rutas locales absolutas: sustituyen a los archivos adjuntos antes
embed		lista de texto	Archivos locales absolutos que incrustar en el texto, que nombra cada uno por su nombre de archivo: <img src="shot.png">

delete_workshop_example

Eliminar una entrega de ejemplo de un taller

Elimina una entrega de ejemplo con sus evaluaciones (la de referencia y las de práctica de los participantes). No se puede deshacer: confírmalo antes con la persona. El servidor pide antes la confirmación de la persona en su aplicación (elicitation MCP); si dice que no, no pasa nada.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
workshopId	✅	entero	El id del taller (id del módulo del curso)
exampleId	✅	entero	Tal como lo da list_workshop_examples

assess_workshop_example

Evaluar una entrega de ejemplo de un taller

Evalúa una entrega de ejemplo con el formulario de evaluación del taller, como assess_workshop_submission evalúa una entrega: la evaluación de un profesor es la de referencia con la que se comparan las de los participantes; la de un participante es su práctica, donde el taller le deja evaluar ejemplos ahora. Devuelve la calificación que da.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
workshopId	✅	entero	El id del taller (id del módulo del curso)
exampleId	✅	entero	Tal como lo da list_workshop_examples
criteria		lista de objeto	En el orden del formulario
feedback		texto	Retroalimentación general para el autor (HTML); sin alias
fields		objeto	Cualquier otro campo del formulario, por nombre

calculate_workshop_grades

Calcular las calificaciones de un taller

Calcula las calificaciones de un taller en la fase de evaluación, como «Recalcular calificaciones»: la de cada entrega a partir de sus evaluaciones, y la de cada evaluación por evaluar según el método del taller, con comparison como su rigor. Las calificaciones modificadas a mano se quedan. Devuelve las entregas y evaluaciones con sus calificaciones (las personas como alias cuando el servidor seudonimiza). Los estudiantes verán las calificaciones cuando se cierre el taller: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
workshopId	✅	entero	El id del taller (id del módulo del curso)
comparison		very strict, strict, fair, lax, very lax	Con qué rigor se comparan las evaluaciones con la mejor; el formulario guarda la última usada

override_workshop_grade

Modificar a mano una calificación de un taller

Modifica a mano una calificación que Moodle calculó en un taller: la de una entrega o la calificación por evaluar de una evaluación (da uno de los dos ids, de get_workshop), con retroalimentación para el autor o el revisor; remove: true quita la modificación y vuelve a contar la calculada. Devuelve la entrega o la evaluación. Los estudiantes lo ven: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
workshopId	✅	entero	El id del taller (id del módulo del curso)
submissionId		entero
assessmentId		entero
grade		entero	Un número entero hasta la calificación del taller por entrega (o por evaluación)
remove		sí o no	Quitar la modificación en su lugar
feedback		texto	HTML; sin alias

get_workshop_allocation

Leer quién evalúa a quién en un taller

Lee la asignación de un taller tal como la muestra su página de asignación manual (en el grupo actual del curso): cada entrega con su autor y los revisores asignados, y los participantes que se pueden asignar como revisores. Las personas como alias cuando el servidor seudonimiza. Requiere el rol de profesor.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
workshopId	✅	entero	El id del taller (id del módulo del curso)

allocate_workshop_reviewer

Asignar un revisor a una entrega de un taller

Asigna un revisor a una entrega, como hace «Añadir revisor» en la página de asignación manual, en cualquier fase. La entrega por su id o por su autor; el revisor, uno que get_workshop_allocation lista como posible revisor (alias cuando el servidor seudonimiza). Un revisor ya asignado se deja como está. Devuelve después los revisores de la entrega. Da trabajo al revisor: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
workshopId	✅	entero	El id del taller (id del módulo del curso)
submissionId		entero	La entrega, tal como la da get_workshop_allocation; o su autor
author		texto	El alias del autor de la entrega, cuando el servidor seudonimiza
authorId		entero	El id de usuario del autor de la entrega, cuando el servidor muestra los nombres
reviewer		texto	El alias del revisor, cuando el servidor seudonimiza
reviewerId		entero	El id de usuario del revisor, cuando el servidor muestra los nombres

remove_workshop_reviewer

Quitar un revisor de una entrega de un taller

Quita la asignación de un revisor a una entrega: Moodle borra su evaluación de ella. Una evaluación ya calificada solo se borra con evenIfAssessed, y su calificación se pierde. Devuelve después los revisores de la entrega. Confírmalo antes con la persona. El servidor pide antes la confirmación de la persona en su aplicación (elicitation MCP); si dice que no, no pasa nada.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
workshopId	✅	entero	El id del taller (id del módulo del curso)
submissionId		entero	La entrega, tal como la da get_workshop_allocation; o su autor
author		texto	El alias del autor de la entrega, cuando el servidor seudonimiza
authorId		entero	El id de usuario del autor de la entrega, cuando el servidor muestra los nombres
reviewer		texto	El alias del revisor, cuando el servidor seudonimiza
reviewerId		entero	El id de usuario del revisor, cuando el servidor muestra los nombres
evenIfAssessed		sí o no	También si ya la ha evaluado (se borran la evaluación y su calificación)

allocate_workshop_randomly

Asignar al azar los revisores de un taller

Asigna entregas a revisores al azar, como la asignación aleatoria del taller: perSubmission revisiones por entrega, o perReviewer por revisor; conservando las asignaciones actuales salvo que keepCurrent sea false (las calificadas nunca se quitan), entre revisores con entrega salvo con withoutSubmission, con autoevaluaciones si se pide y sin compañeros del mismo grupo si se pide. Devuelve cuántas se añadieron y quitaron, el informe de Moodle y sus problemas (no hay revisores suficientes…), y la asignación resultante. Da trabajo a los participantes: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
workshopId	✅	entero	El id del taller (id del módulo del curso)
perSubmission		entero	Revisiones que recibe cada entrega; o perReviewer
perReviewer		entero	Revisiones que hace cada revisor
keepCurrent		sí o no	Conservar las asignaciones que hay (por defecto); false las quita antes, nunca las ya calificadas
withoutSubmission		sí o no	También revisores sin entrega propia; desactivado por defecto
selfAssessment		sí o no	Añadir la autoevaluación de cada autor, donde el taller la permite
excludeSameGroup		sí o no	Sin revisiones entre compañeros del mismo grupo (solo en modo de grupos visibles)

schedule_workshop_allocation

Programar la asignación aleatoria de un taller

Activa o desactiva la asignación programada del taller: activada, Moodle asigna al azar por su cuenta al final de la fase de envío (cuando pasa la fecha límite de entrega), con los ajustes de la asignación aleatoria que se den aquí (los que falten conservan lo que tiene el formulario). Devuelve los ajustes y el estado que le da Moodle (sin fecha límite de entrega nunca se ejecuta). Confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
workshopId	✅	entero	El id del taller (id del módulo del curso)
enabled	✅	sí o no
perSubmission		entero	Revisiones que recibe cada entrega; o perReviewer
perReviewer		entero	Revisiones que hace cada revisor
keepCurrent		sí o no	Conservar las asignaciones que hay (por defecto); false las quita antes, nunca las ya calificadas
withoutSubmission		sí o no	También revisores sin entrega propia; desactivado por defecto
selfAssessment		sí o no	Añadir la autoevaluación de cada autor, donde el taller la permite
excludeSameGroup		sí o no	Sin revisiones entre compañeros del mismo grupo (solo en modo de grupos visibles)

list_notifications

Listar mis notificaciones

Lista las notificaciones de la persona, de la más reciente a la más antigua (solo las no leídas cuando se pide), una página cada vez: limit de ellas (30 por defecto) tras saltar offset; more indica si hay otras que pedir con un offset mayor. Cada una: asunto, texto, de quién es (un alias cuando el servidor seudonimiza), cuándo, si está leída y adónde lleva. Los nombres en los textos se ocultan al seudonimizar.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
unreadOnly		sí o no
limit		entero	Cuántas (30 por defecto)
offset		entero	Cuántas saltar primero, de la más reciente a la más antigua (0 por defecto); con unreadOnly, cuenta las no leídas

mark_notifications_read

Marcar mis notificaciones como leídas

Marca como leídas todas las notificaciones de la persona, como hace "Marcar todas como leídas" en la ventana emergente de notificaciones. Hacerlo dos veces no cambia nada.

Sin parámetros.

list_conversations

Listar mis conversaciones

Lista las conversaciones de mensajes de la persona, de la más reciente a la más antigua: privadas, de grupo o consigo misma, sus miembros (alias cuando el servidor seudonimiza), el número de no leídos y el último mensaje como texto. Por páginas: limit conversaciones (20 por defecto) tras saltarse offset; more dice si hay más. Lee una con get_conversation.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
limit		entero	Cuántas conversaciones (20 por defecto, hasta 100)
offset		entero	Cuántas conversaciones saltarse primero, de la más reciente a la más antigua (0 por defecto)

get_conversation

Leer una conversación

Lee una conversación de mensajes: sus miembros y, de cada mensaje, el remitente (alias cuando el servidor seudonimiza), el texto y la hora; los nombres y datos de contacto en los textos se ocultan al seudonimizar. Por páginas, contando desde el más reciente: limit mensajes (50 por defecto) tras saltarse offset, la primera página con los últimos, y los mensajes de cada página del más antiguo al más reciente; more dice si hay mensajes anteriores. Toma el id de list_conversations.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
conversationId	✅	entero
limit		entero	Cuántos mensajes (50 por defecto, hasta 200)
offset		entero	Cuántos mensajes saltarse primero, contando desde el más reciente (0 por defecto)

send_message

Enviar un mensaje privado

Envía un mensaje privado a alguien, como hace el panel de mensajería: a user (un alias) cuando el servidor seudonimiza; si no, a userId. El texto es plano; sin alias, ya que lo lee el destinatario. Devuelve el mensaje y su conversación. Se envía como la persona, de forma visible: confirma antes el texto y el destinatario con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
user		texto	El alias del participante, tal como lo dan las herramientas de lectura cuando el servidor seudonimiza
userId		entero	El id de usuario del participante, cuando el servidor muestra los nombres
text	✅	texto

message_participants

Enviar un mensaje a varios participantes

Envía un mismo mensaje privado a varios participantes de un curso, como hace "Enviar un mensaje" de la página de participantes: a users (alias) o userIds, o a todos los elegidos por role, group o inactiveSince (todos cuando no se indica nada), excluida la persona. Devuelve quién lo recibió y a quién no escribió Moodle, y por qué. El texto es plano, sin alias. Se envía como la persona, de forma visible: confirma antes el texto y los destinatarios con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
text	✅	texto
users		lista de texto	Los alias de los participantes, tal como los dan las herramientas de lectura cuando el servidor seudonimiza
userIds		lista de entero	Los ids de usuario de los participantes, cuando el servidor muestra los nombres
role		entero	O bien: todos los que tienen este rol
group		entero	O bien: todos los de este grupo
inactiveSince		texto	O bien: todos los que no han accedido al curso desde esta fecha (ISO 8601)

Calendario y pendientes

Herramienta	Descripción	Solo lectura	Profesor	Alumno
list_events	Listar los próximos eventos del calendario	✓	✓	✓
get_event	Leer un evento del calendario	✓	✓	✓
create_event	Crear un evento de curso		✓
update_event	Cambiar un evento del calendario		✓
delete_event	Eliminar un evento del calendario		✓
list_deadlines	Listar las próximas fechas límite	✓	✓	✓
list_pending	Listar lo que me queda	✓		✓
get_activities_overview	Obtener la vista general de actividades de un curso	✓	✓	✓
get_course_updates	Obtener lo que ha cambiado en un curso	✓	✓	✓

list_events

Listar los próximos eventos del calendario

Lista los próximos eventos del calendario de la persona, como hace su vista "Próximos eventos", en un curso o en todos: eventos de curso, fechas de las actividades y los eventos propios de la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId		entero	Solo los de este curso; todos los cursos si falta

get_event

Leer un evento del calendario

Lee un evento del calendario por su id, tal como los da list_events.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
eventId	✅	entero

create_event

Crear un evento de curso

Crea un evento en el calendario de un curso, que ven sus participantes: un nombre, un inicio (ISO 8601 con su zona horaria) y, opcionalmente, una duración y una descripción (HTML). Devuelve el evento. Visible para el curso: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero
name	✅	texto
start	✅	texto	ISO 8601, p. ej. 2026-11-03T10:00:00+01:00
durationMinutes		entero
description		texto	HTML

update_event

Cambiar un evento del calendario

Cambia un evento del calendario mediante el propio formulario del calendario: solo cambia lo que se indica; un nuevo inicio mantiene su duración salvo que se indique una nueva. Las fechas de las actividades se cambian en la actividad. Devuelve el evento tras el cambio. Visible para el curso: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
eventId	✅	entero
name		texto
description		texto	HTML
start		texto	ISO 8601
durationMinutes		entero
until		texto	O el fin, ISO 8601
location		texto
wholeSeries		sí o no	Para un evento repetido: cambiar todos

delete_event

Eliminar un evento del calendario

Elimina un evento del calendario que la persona puede gestionar (un evento de curso, o uno propio), por su id de list_events o create_event. Las fechas de las actividades se cambian en la actividad. No se puede deshacer: confírmalo antes con la persona. El servidor pide antes la confirmación de la persona en su aplicación (elicitation MCP); si dice que no, no pasa nada.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
eventId	✅	entero

list_deadlines

Listar las próximas fechas límite

Lo que la persona tiene que hacer antes de una fecha, según el calendario de Moodle (entregar una tarea, intentar un cuestionario…), en un curso o en todos: desde hace una semana (las vencidas) hasta unos días por delante. Cada una con el id de su actividad, la fecha, si está vencida y la acción que ofrece Moodle. Los profesores reciben pocos eventos de este tipo: para lo que espera calificación, usa get_activities_overview.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId		entero	Un curso; todos los cursos si falta
days		entero	Cuántos días por delante (por defecto 30)

list_pending

Listar lo que me queda

Lista lo que la persona con la sesión iniciada aún tiene que hacer en un curso: actividades cuya finalización se registra y no están completas o, donde no se registra la finalización, actividades calificables aún sin calificación; con sus fechas, restricciones y si se pueden abrir ya. Toma el id del curso de list_courses.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero	El id del curso, tal como lo da list_courses

get_activities_overview

Obtener la vista general de actividades de un curso

La vista general de actividades de un curso en Moodle, tal como la ve la persona: por actividad, sus columnas (fecha de entrega, entregas, lo que falta por calificar, intentos, la calificación propia de la persona, suscripciones a foros…), por tipo o para todos los tipos del curso. Para un profesor, la forma más rápida de ver lo que espera calificación (alerta "Requiere calificación"); para un estudiante, lo que vence y sus resultados. Moodle 5 y posteriores.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero	El id del curso, de list_courses
type		texto	Un tipo de actividad (assign, quiz, forum…; "resource" para todos los tipos de recurso); todos los tipos si falta

get_course_updates

Obtener lo que ha cambiado en un curso

Lo que ha cambiado en las actividades de un curso desde una fecha (ajustes, archivos de contenido, mensajes del foro, entregas, intentos, calificaciones…), tal como Moodle lo registra para la persona, con el nombre y el tipo de cada actividad. Útil al empezar una sesión: lo nuevo desde la última vez.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero	El id del curso, de list_courses
since		texto	Fecha y hora ISO; hace una semana si falta

Como alumno

Herramienta	Descripción	Solo lectura	Profesor	Alumno
get_my_grades	Obtener mis calificaciones	✓		✓
get_assignment	Obtener una tarea como estudiante	✓		✓
save_submission	Guardar mi entrega			✓
submit_assignment	Enviar mi tarea para calificar			✓
get_quiz_info	Obtener la información de un cuestionario y mis intentos	✓	✓	✓
start_quiz_attempt	Iniciar o continuar un intento de cuestionario			✓
get_quiz_attempt	Leer las preguntas de un intento	✓		✓
answer_quiz_questions	Responder preguntas de un cuestionario			✓
finish_quiz_attempt	Enviar un intento de cuestionario			✓
get_attempt_review	Revisar un intento terminado	✓	✓	✓
get_survey	Obtener las preguntas de una encuesta	✓		✓
submit_survey	Responder y enviar una encuesta			✓
get_choice	Leer una consulta	✓	✓	✓
answer_choice	Responder una consulta			✓
get_lesson_page	Leer la página actual de una lección			✓
answer_lesson_page	Responder una página de una lección			✓
get_h5p_activity	Leer una actividad H5P	✓	✓	✓
get_scorm	Leer una actividad SCORM	✓	✓	✓
open_scorm	Abrir un paquete SCORM para hacerlo			✓
set_completion	Marcar una actividad como hecha			✓

get_my_grades

Obtener mis calificaciones

Obtiene el informe de calificaciones de la persona que ha iniciado sesión en un curso: cada elemento de calificación (con el id de su actividad), categoría y el total del curso, con nota, rango, porcentaje, ponderación, letra, comentarios de retroalimentación y contribución, tal como los muestra Moodle. Toma el id del curso de list_courses.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
courseId	✅	entero	El id del curso, tal como lo da list_courses

get_assignment

Obtener una tarea como estudiante

Lee una tarea tal como la ve el estudiante con la sesión iniciada: el enunciado y sus archivos, las fechas, el estado y el contenido de la entrega, la calificación y los comentarios de retroalimentación, y si se puede editar o enviar ahora.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
assignmentId	✅	entero	El id de la tarea (id del módulo del curso), tal como lo da get_course_structure

save_submission

Guardar mi entrega

Guarda la entrega del estudiante con la sesión iniciada en una tarea: su texto en línea (HTML, que sustituye lo que hubiera) y archivos que añadir (rutas locales absolutas). No la envía para calificar cuando la tarea pide a los estudiantes que pulsen enviar: eso lo hace submit_assignment. Devuelve la tarea tal como la ve el estudiante. Cambia la entrega: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
assignmentId	✅	entero	El id de la tarea (id del módulo del curso), tal como lo da get_course_structure
onlineText		texto
files		lista de texto

submit_assignment

Enviar mi tarea para calificar

Envía la entrega guardada para su calificación: después no se puede cambiar salvo que el profesor la reabra. Cuando el sitio pide aceptar una declaración (es trabajo propio…), la llamada falla citándola hasta que acceptStatement sea true. Definitivo: confírmalo antes con la persona, tras comprobar la entrega con get_assignment.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
assignmentId	✅	entero	El id de la tarea (id del módulo del curso), tal como lo da get_course_structure
acceptStatement		sí o no	La persona acepta la declaración de entrega del sitio

get_quiz_info

Obtener la información de un cuestionario y mis intentos

Lee la página de un cuestionario como la persona: descripción, sus reglas (intentos permitidos, método de calificación, límite de tiempo…), fechas, comentarios de retroalimentación generales, los intentos de la persona (con sus ids, en curso o terminados, y sus calificaciones) y si puede empezar uno ahora.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
quizId	✅	entero	El id del cuestionario (id del módulo del curso), tal como lo da get_course_structure

start_quiz_attempt

Iniciar o continuar un intento de cuestionario

Inicia un intento de un cuestionario, o continúa el que está en curso, como hace el botón de la página del cuestionario; devuelve el id del intento y sus preguntas con sus campos y opciones. Iniciarlo consume uno de los intentos permitidos, y empieza a correr el límite de tiempo: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
quizId	✅	entero	El id del cuestionario (id del módulo del curso), tal como lo da get_course_structure

get_quiz_attempt

Leer las preguntas de un intento

Lee todas las preguntas de un intento en curso, página a página: texto, imágenes, campos con sus opciones y las respuestas guardadas hasta el momento.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
attemptId	✅	entero	El id del intento, tal como lo dan start_quiz_attempt o get_quiz_info

answer_quiz_questions

Responder preguntas de un cuestionario

Guarda respuestas en un intento en curso, como hacen las páginas del intento; no termina el intento. Cada respuesta indica el hueco de una pregunta y sus campos por nombre con el valor que dar: el valor de una opción para campos de elección y desplegables, "1" o "0" para casillas de verificación, texto para campos de texto. Devuelve las preguntas con sus respuestas guardadas. Con el rastro realistic se detiene a leer cada página antes.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
attemptId	✅	entero	El id del intento, tal como lo dan start_quiz_attempt o get_quiz_info
answers	✅	lista de objeto

finish_quiz_attempt

Enviar un intento de cuestionario

Envía un intento para su calificación, como hace "Enviar todo y terminar": después no se puede cambiar ninguna respuesta. Devuelve la revisión cuando el cuestionario la muestra. Definitivo: confírmalo antes con la persona, tras comprobar las respuestas con get_quiz_attempt.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
attemptId	✅	entero	El id del intento, tal como lo dan start_quiz_attempt o get_quiz_info

get_attempt_review

Revisar un intento terminado

Lee la revisión de un intento terminado, hasta donde el cuestionario la muestra: estado, puntos y calificación y, por pregunta, si era correcta, la puntuación, los comentarios de retroalimentación y la respuesta correcta. El intento de otra persona (la vista de un profesor) la nombra por su alias, y sus respuestas escritas se ocultan, cuando el servidor seudonimiza.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
attemptId	✅	entero	El id del intento, tal como lo dan start_quiz_attempt o get_quiz_info

get_survey

Obtener las preguntas de una encuesta

Lee una encuesta (el plugin questionnaire, o el feedback de Moodle) como la persona: si puede responderla ahora, sus mensajes (completada, cerrada…) y todas las preguntas de todas las páginas, con si son obligatorias y sus campos (nombres, opciones).

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
activityId	✅	entero	El id de la encuesta (id del módulo del curso), tal como lo da get_course_structure
type	✅	questionnaire, feedback	El tipo de la actividad, tal como lo da get_course_structure

submit_survey

Responder y enviar una encuesta

Responde una encuesta y la envía, página a página según avanza su formulario: responses asigna nombres de campo (de get_survey) a valores ("1"/"0" para casillas de verificación, el valor de una opción para opciones y desplegables, texto en los demás casos). Primero se comprueba cada nombre; las quejas de Moodle (una pregunta obligatoria sin responder) se devuelven por página. Normalmente una respuesta por persona: confirma antes las respuestas con la persona, y pídele los datos personales en lugar de suponerlos.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
activityId	✅	entero	El id de la encuesta (id del módulo del curso), tal como lo da get_course_structure
type	✅	questionnaire, feedback	El tipo de la actividad, tal como lo da get_course_structure
responses	✅	objeto

get_choice

Leer una consulta

Lee una actividad consulta (una votación) tal como la ve la persona: su pregunta, las opciones con sus ids, si está abierta, si se pueden elegir varias y si se puede cambiar la respuesta, y la respuesta de la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
activityId	✅	entero	El id de la actividad (id del módulo del curso), tal como lo da get_course_structure

answer_choice

Responder una consulta

Responde una actividad consulta como la persona, con una opción (varias si la consulta lo permite) por id de get_choice, como hace "Guardar mi elección". Devuelve la consulta resultante. Responde como la persona, y algunas consultas no permiten cambiar la respuesta: confírmalo antes con la persona.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
activityId	✅	entero	El id de la actividad (id del módulo del curso), tal como lo da get_course_structure
optionIds	✅	lista de entero

get_lesson_page

Leer la página actual de una lección

Lee la página de una lección en la que está la persona (iniciando la lección la primera vez): una página de contenido con sus botones, una pregunta con sus campos, o el final con la puntuación. Respóndela con answer_lesson_page.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
activityId	✅	entero	El id de la actividad (id del módulo del curso), tal como lo da get_course_structure

answer_lesson_page

Responder una página de una lección

Avanza en una lección como la persona: pulsa un botón de una página de contenido (por su etiqueta, o por su posición desde 1), o responde los campos de una página de pregunta por nombre (el valor de una opción para opciones y desplegables, texto para texto). Devuelve los comentarios de retroalimentación de Moodle, si los hay, y la página siguiente; llegar al final termina el intento. Las respuestas cuentan para la calificación de la lección y no se pueden deshacer. Con el trail realistic hace una pausa para leer la página antes.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
activityId	✅	entero	El id de la actividad (id del módulo del curso), tal como lo da get_course_structure
button		texto	El botón de una página de contenido, por su etiqueta
buttonPosition		entero	O por su posición, desde 1
responses		objeto	Las respuestas de una página de pregunta: nombre de campo → valor, tal como get_lesson_page da los campos

get_h5p_activity

Leer una actividad H5P

Lee una actividad H5P: su tipo de contenido (la biblioteca H5P), si Moodle registra los intentos, y los intentos de la propia persona con sus puntuaciones. Resolver el contenido en sí (se ejecuta en un reproductor) corresponde a las herramientas de navegador de respaldo.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
activityId	✅	entero	El id de la actividad (id del módulo del curso), tal como lo da get_course_structure

get_scorm

Leer una actividad SCORM

Lee una actividad SCORM tal como la ve la persona: intentos permitidos y realizados, método de calificación, la calificación registrada y la de cada intento, y sus SCO (las partes del paquete) con el estado y la puntuación de la persona en el último intento. Úsala antes de open_scorm, y después de hacer el paquete para ver lo que Moodle ha registrado.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
activityId	✅	entero	El id de la actividad SCORM (id del módulo del curso), tal como lo da get_course_structure

open_scorm

Abrir un paquete SCORM para hacerlo

Abre una actividad SCORM en el reproductor de Moodle, como la persona, en la pestaña de las herramientas del navegador: continúa el último intento salvo con newAttempt, en el primer SCO salvo con scoId. Abrirla inicia un intento en Moodle. Después, haz el paquete con las herramientas del navegador: browser_snapshot lo lee (las refs dentro de su marco empiezan por f, como f2e9), browser_click, browser_type y browser_select actúan sobre ellas, y browser_wait espera a sus textos. Al terminar, comprueba el resultado con get_scorm en lugar de suponerlo. Nada marca un SCORM como hecho o calificado salvo hacerlo.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
activityId	✅	entero	El id de la actividad SCORM (id del módulo del curso), tal como lo da get_course_structure
scoId		entero	El SCO que abrir, tal como lo da get_scorm; el primero si falta
newAttempt		sí o no	Iniciar un intento nuevo en lugar de continuar el último

set_completion

Marcar una actividad como hecha

Marca la finalización propia de la persona en una actividad con finalización manual, hecha o no hecha, como hace su botón "Marcar como hecho". Las actividades que se completan solas (al verlas, por calificación, por entrega) no se pueden marcar: Moodle lo indica. Hacerlo dos veces no cambia nada.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
activityId	✅	entero	El id de la actividad (id del módulo del curso), tal como lo da get_course_structure
done	✅	sí o no

Navegador

Son para lo que no cubre ninguna otra herramienta: un plugin, un ajuste poco común, el interior de un paquete SCORM. El agente las usa solo en tu sitio, nunca escribe contraseñas y dice qué tarea las necesitó. Con pseudonymize, nunca abren páginas sobre personas (participantes, calificaciones, informes, foros, mensajes).

Herramienta	Descripción	Solo lectura	Profesor	Alumno
browser_navigate	Navegador: abrir una página		✓	✓
browser_snapshot	Navegador: leer la página	✓	✓	✓
browser_click	Navegador: hacer clic		✓	✓
browser_type	Navegador: escribir		✓	✓
browser_select	Navegador: elegir opciones		✓	✓
browser_upload	Navegador: elegir archivos		✓	✓
browser_screenshot	Navegador: captura de pantalla	✓	✓	✓
browser_wait	Navegador: esperar	✓	✓	✓

browser_navigate

Navegador: abrir una página

Abre una página del sitio Moodle configurado en la pestaña de las herramientas del navegador: una URL del sitio, o una ruta relativa a él. Otros sitios se rechazan. Un último recurso: úsala solo cuando ninguna herramienta de Moodle cubra la tarea, y di cuál es la tarea, para que se pueda crear una herramienta para ella. Trabaja en una pestaña de la sesión del servidor (la que muestra show_browser; las herramientas de Moodle pueden moverla mientras el navegador se muestra).

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
url	✅	texto	Una URL del sitio, o una ruta relativa a él (course/view.php?id=3)

browser_snapshot

Navegador: leer la página

La página de la pestaña de las herramientas del navegador como árbol de accesibilidad (roles, nombres, valores), con una ref por elemento ([ref=e12]) para las demás herramientas del navegador. Por defecto solo la región principal (#region-main, donde Moodle pone el contenido), o la página entera, o el subárbol de un elemento por su ref. Se corta a los 30000 caracteres: si se corta, haz una instantánea de una parte más reducida. Un último recurso: úsala solo cuando ninguna herramienta de Moodle cubra la tarea, y di cuál es la tarea, para que se pueda crear una herramienta para ella.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
scope		main, page	"main" (por defecto): la región principal de Moodle; "page": todo, navegación incluida
ref		texto	Solo el subárbol de este elemento (de una instantánea anterior)

browser_click

Navegador: hacer clic

Hace clic en un elemento de la pestaña de las herramientas del navegador por su ref de la instantánea (un enlace, botón, casilla, pestaña…) y espera a la página a la que lleva. Los enlaces a otros sitios se bloquean. Un clic puede cambiar el sitio (guardar, eliminar, enviar): confírmalo antes con la persona, como con cualquier cambio en Moodle. Un último recurso: úsala solo cuando ninguna herramienta de Moodle cubra la tarea, y di cuál es la tarea, para que se pueda crear una herramienta para ella.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
ref	✅	texto	La ref del elemento de la última browser_snapshot, como e12
doubleClick		sí o no

browser_type

Navegador: escribir

Rellena un campo de texto de la pestaña de las herramientas del navegador por su ref de la instantánea, sustituyendo lo que contiene; opcionalmente pulsa Intro después. Los campos de contraseña se rechazan: la persona inicia sesión por sí misma (login). Un último recurso: úsala solo cuando ninguna herramienta de Moodle cubra la tarea, y di cuál es la tarea, para que se pueda crear una herramienta para ella.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
ref	✅	texto	La ref del elemento de la última browser_snapshot, como e12
text	✅	texto
submit		sí o no	Pulsar Intro después de escribir

browser_select

Navegador: elegir opciones

Elige opciones en un desplegable de la pestaña de las herramientas del navegador por su ref de la instantánea, por sus valores o sus etiquetas visibles (varias en un desplegable múltiple). Un último recurso: úsala solo cuando ninguna herramienta de Moodle cubra la tarea, y di cuál es la tarea, para que se pueda crear una herramienta para ella.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
ref	✅	texto	La ref del elemento de la última browser_snapshot, como e12
options	✅	lista de texto

browser_upload

Navegador: elegir archivos

Pone archivos locales en un campo de archivo de la pestaña de las herramientas del navegador por su ref de la instantánea (en el selector de archivos de Moodle, el campo "Subir un archivo"), como si la persona los hubiera elegido. Rutas absolutas. Un último recurso: úsala solo cuando ninguna herramienta de Moodle cubra la tarea, y di cuál es la tarea, para que se pueda crear una herramienta para ella.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
ref	✅	texto	La ref del elemento de la última browser_snapshot, como e12
paths	✅	lista de texto	Rutas absolutas de archivos locales

browser_screenshot

Navegador: captura de pantalla

nota

Solo con MOODLE_MCP_STUDENT_DATA=clear: lo que devuelve no se puede seudonimizar. Consulta Privacidad del alumnado.

Una imagen de la pestaña de las herramientas del navegador (lo que está a la vista), o de un elemento por su ref de la instantánea. Para lo que el árbol de accesibilidad no puede decir (maquetación, imágenes, un canvas); el texto se lee con browser_snapshot. Un último recurso: úsala solo cuando ninguna herramienta de Moodle cubra la tarea, y di cuál es la tarea, para que se pueda crear una herramienta para ella.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
ref		texto	La ref del elemento de la última browser_snapshot, como e12

browser_wait

Navegador: esperar

Espera en la pestaña de las herramientas del navegador hasta que aparezca un texto, hasta que desaparezca (en la página o en cualquier marco dentro de ella, como el de un paquete SCORM), o unos segundos (como máximo 30): para páginas que cargan o cambian por sí solas. Un último recurso: úsala solo cuando ninguna herramienta de Moodle cubra la tarea, y di cuál es la tarea, para que se pueda crear una herramienta para ella.

Parámetros

Parámetro	Obligatorio	Tipo	Descripción
text		texto	Esperar hasta que aparezca este texto
textGone		texto	Esperar hasta que desaparezca este texto
seconds		número	Esperar este tiempo (con un texto: lo máximo que esperar; por defecto 10)