Referencia de tools¶
63 tools en la versión 0.8.6. Por alcance: 26 read, 26 write y 11 admin. La referencia las reparte en dos páginas: 27 de lectura (las 26 read más search_users) y 36 de escritura (las 26 write más las otras 10 admin). Los clientes las descubren con tools/list. No se listan las tools desactivadas, las de escritura mientras la escritura esté apagada ni las de un alcance que el usuario o el token no pueden usar. Los errores dentro de una tool vuelven como error de tool con un mensaje corto (por ejemplo Course not found.).
Además de las tools, el servidor ofrece tres prompts MCP (design_course, create_quiz_from_content, grade_assignment).
Lectura · General¶
| Tool | Permiso de Moodle |
|---|---|
site_info |
Ninguno. Los datos de server solo con moodle/site:config |
search_courses |
Visibilidad del curso para el usuario |
list_categories |
Visibilidad de la categoría; canCreate refleja moodle/course:create |
get_course_structure |
Acceso al curso |
list_participants |
moodle/course:viewparticipants (moodle/site:viewuseridentity para el email, moodle/site:accessallgroups para todos los grupos) |
list_activities |
Acceso al curso |
get_grades_summary |
moodle/grade:view; moodle/grade:viewall para medias y otros usuarios; las notas ocultas requieren moodle/grade:viewhidden |
get_task_status |
Solo el usuario que encoló la tarea o un administrador del sitio |
get_activity_settings |
moodle/course:manageactivities |
Lectura · Estudiante¶
| Tool | Permiso de Moodle |
|---|---|
get_my_deadlines |
Eventos de acción del calendario de ese usuario; visibilidad de la actividad |
get_my_grades |
moodle/grade:view en cada curso |
get_my_progress |
Acceso al curso |
get_assignment_details |
mod/assign:view |
get_forum_posts |
mod/forum:viewdiscussion |
get_calendar_events |
Visibilidad del calendario |
search_course_content |
Solo actividades visibles |
Lectura · Profesor¶
| Tool | Permiso de Moodle |
|---|---|
get_ungraded_work |
mod/assign:grade, mod/quiz:grade |
get_inactive_students |
moodle/course:viewparticipants y report/outline:view |
get_submissions_status |
mod/assign:grade (moodle/site:accessallgroups para ver todos los grupos) |
get_submission |
mod/assign:grade (mod/assign:viewblinddetails para ver identidades con calificación anónima) |
get_quiz_results |
mod/quiz:viewreports |
get_activity_completion_report |
report/progress:view |
get_course_logs_summary |
report/log:view |
get_forum_unanswered |
mod/forum:viewdiscussion |
Lectura · Mensajería¶
| Tool | Permiso de Moodle |
|---|---|
list_conversations |
Solo las conversaciones del propio usuario |
get_conversation_messages |
Ser miembro de la conversación |
Lectura · Cuentas (alcance admin)¶
| Tool | Permiso de Moodle |
|---|---|
search_users |
Alcance admin y moodle/user:viewdetails (sistema) |
Escritura · Cursos y actividades¶
| Tool | Permiso de Moodle |
|---|---|
create_course |
moodle/course:create en la categoría; una copia necesita además moodle/backup:backupcourse y moodle/backup:backuptargetimport (moodle/backup:userinfo con datos de usuario) |
add_section |
moodle/course:update |
add_activity |
moodle/course:manageactivities y mod/<tipo>:addinstance (moodle/grade:managegradingforms para una rúbrica) |
update_activity |
La comprobación normal de Moodle para editar actividades (moodle/course:manageactivities); moodle/course:activityvisibility para cambiar visible |
set_visibility |
moodle/course:visibility, moodle/course:sectionvisibility o moodle/course:activityvisibility, según el objetivo |
delete_activity |
moodle/course:manageactivities |
delete_section |
moodle/course:update |
build_course |
Curso nuevo: moodle/course:create en la categoría; curso existente: moodle/course:manageactivities |
update_course |
Por campo: moodle/course:changefullname (fullName), moodle/course:changeshortname (shortName), moodle/course:changesummary (summary y la imagen), moodle/course:visibility (visible), moodle/course:setforcedlanguage (lang); el resto, moodle/course:update |
set_course_image |
moodle/course:update |
set_course_completion |
moodle/course:update |
set_availability |
Actividades, moodle/course:manageactivities; secciones, moodle/course:update |
Escritura · Cuestionarios y preguntas¶
| Tool | Permiso de Moodle |
|---|---|
create_quiz |
moodle/course:manageactivities y mod/quiz:addinstance |
add_quiz_questions |
mod/quiz:manage y moodle/question:add (moodle/question:managecategory para crear una categoría) |
import_questions |
moodle/question:add (mod/quiz:manage para añadirlas a un cuestionario) |
Escritura · Calificación¶
| Tool | Permiso de Moodle |
|---|---|
grade_submission |
Alcance write, escritura activada y mod/assign:grade |
Escritura · Matriculación, roles y grupos¶
| Tool | Permiso de Moodle |
|---|---|
enrol_user |
enrol/manual:enrol |
unenrol_user |
enrol/manual:unenrol |
set_user_role |
moodle/role:assign |
create_group |
moodle/course:managegroups |
add_group_members |
moodle/course:managegroups |
remove_group_members |
moodle/course:managegroups |
Escritura · Foros y mensajería¶
| Tool | Permiso de Moodle |
|---|---|
create_forum_discussion |
mod/forum:addnews en el foro de avisos y mod/forum:startdiscussion en los demás; mod/forum:pindiscussions para pinned |
reply_forum_post |
mod/forum:replynews en el foro de avisos y mod/forum:replypost en los demás |
send_private_message |
moodle/site:sendmessage |
reply_conversation |
moodle/site:sendmessage y ser miembro de la conversación |
Escritura · Cuentas de usuario (alcance admin)¶
| Tool | Permiso de Moodle |
|---|---|
create_user |
Alcance admin, escritura activada y moodle/user:create (sistema) |
create_users |
Alcance admin, escritura activada y moodle/user:create (sistema) |
update_user |
Alcance admin, escritura activada y moodle/user:update (sistema) |
suspend_user |
Alcance admin, escritura activada y moodle/user:update (sistema) |
unsuspend_user |
Alcance admin, escritura activada y moodle/user:update (sistema) |
Escritura · Políticas del sitio (alcance admin)¶
| Tool | Permiso de Moodle |
|---|---|
set_site_policy_handler |
Alcance admin, escritura activada y moodle/site:config |
create_policy |
Alcance admin, escritura activada y tool/policy:managedocs |
update_policy |
Alcance admin, escritura activada y tool/policy:managedocs |
list_policies |
Alcance admin, escritura activada y tool/policy:managedocs |
get_policy_acceptances |
Alcance admin, escritura activada y tool/policy:viewacceptances |