Skip to main content
Glama

mcp-usc

Local, HTTP-first MCP server for the Moodle Virtual Campus of the Universidade de Santiago de Compostela. It allows querying courses, calendar, messages, forums, materials, assignments and quizzes, as well as searching for exam dates on official USC pages and PDFs.

Version 0.3.0 extends student coverage to 301 studied Moodle capabilities: 192 allowed reads and 109 identified actions. Only twelve private changes of unambiguous scope can be executed through the generic interface; posts, gradable activities, submissions, quizzes and deletions use contextual tools. Every operation with an effect requires a preview, a single-use token and approval from the MCP client.

Design principles

  • The MCP server uses STDIO; "HTTP-first" describes the connection between this process and Moodle/USC.

  • Normal reads and writes do not automate a browser.

  • The official Moodle REST API is preferred when there is a legitimate token.

  • With a MoodleSession cookie, reads use same-origin AJAX and direct /pluginfile.php downloads. HTML forms are reserved for already-confirmed quiz operations.

  • Playwright only opens a visible browser to complete Microsoft Entra/MFA and obtain the initial cookie. It closes when the login finishes.

  • All remote text —names, messages, questions, notices and documents— is marked as untrusted content and is never interpreted as instructions.

  • The connector acts only with the permissions of the authenticated account: it does not elevate privileges or impersonate faculty or administration.

  • It must be configured with a student account and a least-privilege token. Moodle's shared APIs always respect effective permissions, and an account with additional roles could see more data than a regular student.

It does not query email or Teams. An internal Moodle message can generate external notifications depending on the recipient's settings; the preview warns about this before sending.

Related MCP server: cvuex-mcp

Requirements

  • Windows, Linux or macOS;

  • Python 3.11 or later;

  • uv recommended;

  • an active USC account for private data;

  • optionally, a Moodle Web Services token that exposes the required functions.

Installation

git clone https://github.com/PabloPC05/mcp-usc.git
cd mcp-usc
uv sync --extra dev

This is enough to run the server with a REST token or with an already-stored session. Install Playwright only if you need to create or renew the session through the login assistant:

uv sync --extra dev --extra browser-auth
uv run playwright install chromium

The assistant can use Chromium or an installed Chrome/Edge:

$env:USC_BROWSER_CHANNEL = "chrome" # también "msedge" o "chromium"

Authentication and HTTP transports

The connector automatically selects the private transport in this order:

  1. Official REST if USC_MOODLE_TOKEN or USC_MOODLE_TOKEN_FILE provides a token.

  2. HTTP with the MoodleSession cookie stored by keyring.

REST token

Use only a legitimate token issued by Moodle for your account and service:

$env:USC_MOODLE_TOKEN = "..."
uv run mcp-usc status

It can also be read from a protected local file:

$env:USC_MOODLE_TOKEN_FILE = "C:\ruta\privada\moodle-token.txt"

Do not use your USC password with login/token.php or store it in .env. The fact that a function exists in Moodle does not imply it is enabled in the service associated with the token.

uv run mcp-usc login
uv run mcp-usc status

Complete Microsoft Entra and MFA personally in the visible window. The program extracts only MoodleSession, checks the session over HTTP and stores the cookie under the key moodle-session in the system's secure store —Credential Manager on Windows—. The password does not go through the MCP.

After login, all operations use httpx:

  • /user/preferences.php provides the identity and the ephemeral sesskey without opening the dashboard;

  • /lib/ajax/service.php executes functions marked as AJAX;

  • reads fail closed if Moodle does not publish them via AJAX;

  • authenticated downloads keep the cookie, accept only direct /pluginfile.php and apply local limits;

  • only certain quiz operations, after explicit confirmation, may use HTML forms.

The sesskey is neither persisted nor returned. As required by the AJAX protocol, it may appear in the URL seen by Moodle's infrastructure. The cookie is equivalent to a credential while it is valid: do not copy, log, publish or sync it. When it expires, repeat mcp-usc login.

Compatibility matrix

Capability

REST token

HTTP session

Courses, Timeline and calendar

REST API

AJAX; no fallback to pages that record views

Conversations and messages

REST

AJAX

Forums and discussions

REST

AJAX when available; no HTML fallback

Posts in a discussion

REST with confirmation

AJAX with confirmation, if the function exists

Publish forum discussion/reply

REST

Not safely available via AJAX

Create/delete personal events

REST

Not safely available via AJAX

Submit/withdraw Choice response

REST

Not safely available via AJAX

Materials and resources

REST

AJAX and direct /pluginfile.php download; never view.php

Reading and modifying assignments

REST

Not safely available

Submission files

REST + /webservice/upload.php multipart

The JavaScript filemanager is not manipulated

Quizzes

REST

AJAX for pure reads; form only after confirming actions

Moodle's filemanager manager creates drafts via JavaScript and is not equivalent to a standard multipart field. If a submission only offers that manager, replacing or deleting its files requires an authorized REST token; public file tools in session mode stop without modifying anything. Playwright is not used to emulate the file manager.

Authorized local files

Upload tools are disabled until an allowlist folder is configured:

$env:USC_UPLOAD_ROOT = "C:\Users\TU_USUARIO\Documents\mcp-usc-uploads"
$env:USC_MAX_UPLOAD_BYTES = "52428800"

USC_UPLOAD_ROOT must exist. Only regular files resolved inside that folder are accepted; paths that escape it are not followed and the same file is not allowed twice. The preview shows relative path, name, size and SHA-256 before issuing a token.

Local upload limits:

  • maximum 20 files per operation;

  • USC_MAX_UPLOAD_BYTES applies to both each file and the total;

  • default value: 50 MiB (52428800 bytes);

  • configurable range: from 1 byte to 100 MiB;

  • online text has an additional limit of 1 MiB.

replace_submission_files replaces the complete set of submission files; it does not silently add one to the existing ones. Before issuing the confirmation it checks that the service allows uploads and that the submission only has the file plugin active. Likewise, REST text saving is only enabled when onlinetext is the only active plugin. Moodle processes all plugins in mod_assign_save_submission, so an unknown combination is rejected before creating a draft or modifying the submission.

Public exam sources

Each USC center publishes its own calendars. Configure canonical pages or PDFs separated by semicolons:

$env:USC_EXAM_SOURCES = "https://www.usc.gal/gl/centro/MI_CENTRO/horarios/cursos;https://assets.usc.gal/ruta/calendario.pdf"

The search uses direct HTTP, accepts only HTTPS under usc.gal/usc.es, follows at most five redirects and downloads at most 15 MB per document. It does not do mass crawling: it queries the indicated sources and their immediate exam/PDF links. Each piece of evidence keeps URL, PDF page when applicable and query time; discrepant sources are shown as a conflict.

Connecting with Codex

From PowerShell on this machine:

codex mcp add usc-campus -- uv --directory C:\Users\pablo\mcp-usc run mcp-usc serve
codex mcp list

To include public sources from the MCP configuration:

codex mcp remove usc-campus
codex mcp add usc-campus --env USC_EXAM_SOURCES="https://www.usc.gal/gl/centro/MI_CENTRO/horarios/cursos" -- uv --directory C:\Users\pablo\mcp-usc run mcp-usc serve

Restart the client or open a new session to load the server. According to the official OpenAI documentation, the MCP configuration is shared between the ChatGPT app, Codex CLI and the IDE extension on the same host.

Also enable host approval for all writes in %USERPROFILE%\.codex\config.toml:

[mcp_servers.usc-campus]
command = "uv"
args = ["--directory", 'C:\Users\pablo\mcp-usc', "run", "mcp-usc", "serve"]
default_tools_approval_mode = "writes"

MCP annotations, preview, token and host approval are complementary layers; none replaces a human decision about the exact parameters.

MCP tools

Version 0.3.0 exposes 75 tools: 39 reads, 18 previews and 18 operations with effect. The complete capability study explains the inventory, the security boundaries and the differences between Moodle 4.5 and 5.2.

Group

Reading

Preview

Writing

Student catalog

list_student_capabilities, call_student_read, profile, preferences, participants, groups, grades, progress, notifications, badges, and private files

preview_student_action

execute_student_action

Campus and calendar

auth_status, list_courses, list_pending_work, list_upcoming_events, get_work_item, list_announcements, list_calendar_events

create or delete a personal event

create or delete a personal event

Messages and forums

list_messages, list_conversation_messages, list_forums, list_forum_discussions, search_message_contacts; list_discussion_posts is kept but fails closed

message, post inspection, new discussion or reply

send message, inspect posts, create discussion or reply

Choice

catalog reading functions

submit or withdraw a response

submit or withdraw your own response

Materials and exams

list_course_contents, list_course_resources, read_course_resource, list_exam_sources, search_exam_dates

—

—

Assignments

list_assignments, get_submission_status, check_submission_reopen

preview_save_online_submission, preview_replace_submission_files, preview_delete_submission_files, preview_submit_assignment, preview_remove_submission

save_online_submission, replace_submission_files, delete_submission_files, submit_assignment, remove_submission

Quizzes

list_quizzes, list_quiz_attempts, final review and best grade

inspect active attempt, start, save, or finish

inspect active attempt, start, save, or finish

call_student_read only accepts the 192 functions explicitly included in the allowlist; it is not an arbitrary Moodle proxy. With a REST token, list_student_capabilities(available_only=true) lets you see which ones the configured service advertises. With an AJAX session, full availability is not always discoverable, and each call fails closed if Moodle does not expose the function.

The twelve generic actions are limited to your own preferences, private favorites, muting or marking conversations/notifications, keeping an unsent draft, and flagging a question. The new contextual actions resolve by proprietary HTTP, course, forum, group, audience, phase, and options before issuing confirmation:

  • create or delete personal calendar events;

  • start a discussion or reply publicly in a forum, without attachments or private replies;

  • submit or withdraw your own responses to a Choice activity.

These six contextual actions require a legitimate REST token to advertise them. Moodle 4.5–5.2 does not normally mark its functions as AJAX; cookie mode stops before previewing and does not try to emulate them with a browser.

The catalog also identifies student actions that do not yet have a safe executor. They are published as generic_execution_supported=false: appearing in the inventory does not allow executing them, nor does it imply that the USC has the corresponding module or plugin active.

Messages, forums, and materials

  • list_messages reads received or sent messages without marking them. list_conversations is kept only for compatibility and fails closed: certain Moodle versions can create and favorite a conversation with yourself when running that supposed read.

  • Forums include all visible ones, not just announcements. Moodle can mark posts as read when running mod_forum_get_discussion_posts; that is why list_discussion_posts fails closed and the preview_inspect_discussion_posts / inspect_discussion_posts pair requires confirmation before traversing posts and attachment metadata.

  • search_message_contacts creates a temporary reference to the recipient. preview_message requires a recent search, shows name, ID, and text, and never sends.

  • list_course_contents lists sections, activities, pages, links, and files.

  • list_course_resources returns opaque references valid for ten minutes. Only a recent reference can be used with read_course_resource.

  • read_course_resource supports PDF, text/HTML, and OOXML (.docx, .pptx, .xlsx). By default it limits the download to 25 MiB, text to 100,000 characters, and PDFs to 100 pages; the maximums accepted per call are 50 MiB, 500,000 characters, and 300 pages.

  • In session mode, contents and announcements require a pure AJAX function, and resources must point directly to /pluginfile.php; opening course/view.php, mod/*/view.php, or forum pages is rejected because it can register visits, mark reads, or change completion.

Assignments and submissions

  • With a REST token that advertises the required functions, you can list assignments and query the draft, files, online text, feedback, and permissions.

  • Assignment HTML pages register views and can change completion; therefore all assignment reads, previews, and writes fail before opening them in session mode.

  • Saving text, replacing/deleting files, submitting for grading, or removing the entire submission are distinct writes, each with its own preview.

  • submit_assignment can close draft editing and must respect the submission statement that Moodle shows.

  • remove_submission uses mod_assign_remove_submission, available in Moodle 4.5 or later. It is destructive and is not equivalent to "reopening."

  • check_submission_reopen never changes state. If the submission is already editable, it reports so; if it is closed, the standard API reserves reopening to teaching staff. The connector does not try to bypass that restriction: you must request reopening from the instructor through normal channels.

Quizzes

  • You can list quizzes and your own attempts and read the permitted review of an already finished attempt.

  • Opening the data or summary of an active attempt can cause Moodle to process an expiry and change its state. That is why get_quiz_attempt_page and get_quiz_attempt_summary fail closed; preview_inspect_quiz_attempt shows the risk and inspect_quiz_attempt requires confirmation.

  • In session mode, pure lists require AJAX. Forms are only opened in the second, confirmed call to inspect a potentially stateful attempt, start it, save, or finish; the preview does not open mod/quiz/view.php.

  • start_quiz can immediately activate a timer.

  • save_quiz_answers modifies an open attempt but does not finish it.

  • finish_quiz is usually irreversible.

  • Questions and field names come from Moodle, are treated as untrusted data, and the connector never infers whether an answer is correct.

  • Each write operation requires an independent preview; a previous approval does not authorize the next step of the attempt.

Confirmations and writes

Every write follows two calls:

  1. preview_* validates the state and returns the visible parameters plus a confirmation_token.

  2. The write tool consumes that token only if the action and parameters match exactly.

Tokens live only in memory, expire after five minutes, and are single-use. Changing text, recipient, files, answers, attempt, or any other input invalidates the confirmation. The host's writes approval must remain active for the second call to require human intervention.

Each contact reference and confirmation token is also bound to the Moodle user_id that created it. If the account or session changes between the preview and the write, the operation is rejected. A valid response to an HTML form only confirms that the request was sent: outcome="unknown" is returned when Moodle does not offer an unambiguous postcondition, and it is never retried over a second transport in response to an ambiguous reply.

A timeout or connection drop during a write is ambiguous: Moodle may have applied the operation even though the client did not receive the response. Do not automatically retry a message, submission, save, or finish. Re-read the conversation, the submission state, or the attempt and decide based on that evidence; in a timed quiz, also check the clock directly in Moodle.

Testing

uv run pytest
uv run ruff check .

The suite replaces HTTP, keyring, forms, uploads, and downloads with test doubles. It contains no tokens, cookies, or real data and does not run any writes against the USC. Real access is validated only manually and locally.

Official sources

The contract was cross-checked against official documentation and code:

Prior work reviewed

Licensed projects were studied to avoid repeating already-solved patterns. Architecture ideas and public contracts were reused, not credentials or incompatible code:

loyaniu/moodle-mcp was used only to compare scope because the repository does not declare a license; no code was copied.

Known limitations

  • The availability of each Web Service depends on the version, configuration and permissions that the USC assigns to the token or session.

  • The OIDC session and MoodleSession expire; mcp-usc login must be run again.

  • AJAX and quiz forms may change between versions. The connector fails closed if it cannot safely recognize an operation.

  • Assignments require REST: their pages log views and the JavaScript filemanager is not equivalent to a native multipart field.

  • Deleting a complete submission requires Moodle 4.5+ and current permissions. Reopening a closed submission is up to the teaching staff.

  • Not all teaching staff use the Virtual Campus; email or Teams may contain information that this server does not consult.

  • A Moodle date may be continuous assessment and a public date, an official exam. They are kept as separate sources.

Available Tools

91 tools
auth_statusA
Read-onlyIdempotent

Comprueba si la sesión local/token del Campus funciona, sin devolver secretos.

Inputs: no named parameters.

call_student_readC
Read-onlyIdempotent

Ejecuta una función Moodle incluida explícitamente en la lista blanca de lecturas.

Inputs: function (required), arguments.

cancel_choice_responseC
Destructive

Retira solo las respuestas Choice propias aprobadas en la vista previa reciente.

Inputs: choice_id (required), course_id (required), confirmation_token (required).

check_submission_reopenC
Read-onlyIdempotent

Comprueba si el alumno puede seguir editando; nunca usa privilegios de profesor.

Inputs: assignment_id (required), course_module_id.

create_forum_discussionC
Destructive

Publica la discusión sin adjuntos aprobada para el foro y audiencia exactos.

Inputs: message (required), subject (required), forum_id (required), course_id (required), +2 more.

create_personal_calendar_eventB
Destructive

Crea el evento personal exacto confirmado mediante una vista previa reciente.

Inputs: name (required), timestart (required), confirmation_token (required), repeats, +2 more.

delete_personal_calendar_eventC
Destructive

Borra solo el evento personal o serie exactos aprobados en la vista previa.

Inputs: event_id (required), confirmation_token (required), scope.

delete_submission_filesC
Destructive

Elimina todos los archivos de una entrega editable tras confirmación.

Inputs: assignment_id (required), confirmation_token (required), course_module_id.

describe_mcp_uscA
Read-onlyIdempotent

Explica para qué sirve este MCP, sus límites y su modelo de seguridad, sin usar la red.

Inputs: no named parameters.

execute_student_actionB
Destructive

Ejecuta la acción Moodle exacta aprobada mediante una previsualización reciente.

Inputs: function (required), arguments (required), confirmation_token (required).

finish_quizC
Destructive

Finaliza el intento exacto ya previsualizado; normalmente es irreversible.

Inputs: attempt_id (required), confirmation_token (required), time_up, responses, +1 more.

get_degree_class_timetableC
Read-onlyIdempotent

Consulta el horario de la titulación elegida y agrega sus centros sin mezclar planes.

Inputs: degree_url (required), academic_year (required), course_number (required), semester, +4 more.

get_my_class_timetableA
Read-onlyIdempotent

Consulta el horario usando el perfil académico local, sin pedir sus identificadores.

Inputs: semester, date_in_week, academic_year, subject_query.

get_my_completionB
Read-onlyIdempotent

Consulta progreso y finalización propios sin marcar actividades como completadas.

Inputs: course_id (required).

get_my_gradesA
Read-onlyIdempotent

Lee las calificaciones propias globales o de una materia; no registra visita al informe.

Inputs: course_id.

get_my_official_exam_scheduleB
Read-onlyIdempotent

Cruza los códigos de mis cursos Moodle con calendarios oficiales USC del año indicado.

Inputs: academic_year (required), degree_keys.

get_my_preferencesA
Read-onlyIdempotent

Lee preferencias propias; no cambia idioma, avisos ni configuración de mensajes.

Inputs: name.

get_my_profileA
Read-onlyIdempotent

Lee el perfil de la cuenta autenticada sin registrar una visita al perfil.

Inputs: no named parameters.

get_official_exam_datesC
Read-onlyIdempotent

Obtiene convocatorias USC por código y curso exactos, distinguiendo planes homónimos.

Inputs: academic_year (required), subject_codes (required), degree_keys.

get_private_files_infoA
Read-onlyIdempotent

Consulta cuotas y recuentos de archivos privados; no crea borradores ni descarga nada.

Inputs: no named parameters.

get_quiz_attempt_pageD
Read-onlyIdempotent

Bloqueada: Moodle puede cambiar el intento al leer; usa el flujo inspect confirmado.

Inputs: attempt_id (required), page, preflight_data.

get_quiz_attempt_reviewA
Read-onlyIdempotent

Lee la revisión permitida de un intento finalizado sin registrar una visita.

Inputs: attempt_id (required), page.

get_quiz_attempt_summaryD
Read-onlyIdempotent

Bloqueada: Moodle puede procesar un timeout; usa el flujo inspect confirmado.

Inputs: attempt_id (required), preflight_data.

get_quiz_best_gradeC
Read-onlyIdempotent

Consulta la mejor calificación propia que Moodle permite mostrar para un cuestionario.

Inputs: quiz_id (required).

get_submission_statusB
Read-onlyIdempotent

Consulta borrador, archivos, texto, feedback y permisos actuales de una entrega.

Inputs: assignment_id (required), course_module_id.

get_work_itemA
Read-onlyIdempotent

Obtiene el detalle visible de un evento/tarea por su identificador Moodle.

Inputs: event_id (required).

inspect_discussion_postsC
Destructive

Lee posts confirmados; Moodle puede marcarlos como leídos y registrar seguimiento.

Inputs: discussion_id (required), confirmation_token (required), limit, offset.

inspect_quiz_attemptD
Destructive

Abre la vista confirmada; Moodle puede procesar el vencimiento y cambiar el intento.

Inputs: attempt_id (required), confirmation_token (required), page, summary, +1 more.

inspect_submission_statusD

Abre una vez la entrega confirmada; Moodle puede registrar vista/completion.

Inputs: course_module_id (required), confirmation_token (required).

list_announcementsC
Read-onlyIdempotent

Lee avisos recientes de los foros de novedades/anuncios de las materias.

Inputs: limit, course_ids, since_days. Returns: result

list_assignmentsB
Read-onlyIdempotent

Lista tareas configuradas en Moodle, incluidos plazos y tipos de entrega.

Inputs: course_ids.

list_calendar_eventsB
Read-onlyIdempotent

Lee todos los eventos visibles de un intervalo, no solo acciones del Timeline.

Inputs: end (required), start (required), course_ids, include_site_events, +1 more.

list_conversation_messagesB
Read-onlyIdempotent

Lee mensajes y miembros visibles de una conversación; no envía ni borra nada.

Inputs: conversation_id (required), limit, newest, offset, +1 more.

list_conversationsD
Read-onlyIdempotent

Compatibilidad: falla cerrado; usa list_messages para evitar un write oculto de Moodle.

Inputs: limit, offset, favourites, conversation_type.

list_course_contentsA
Read-onlyIdempotent

Lista secciones, actividades, páginas, enlaces y archivos visibles de una materia.

Inputs: course_id (required), limit, offset, section_id.

list_course_participantsA
Read-onlyIdempotent

Lista únicamente los participantes que Moodle permite ver en una materia.

Inputs: course_id (required), limit, offset.

list_course_resourcesC
Read-onlyIdempotent

Lista archivos descargables y crea referencias locales seguras para leerlos.

Inputs: course_id (required), limit, offset, section_id.

list_coursesA
Read-onlyIdempotent

Lista las materias del usuario. No modifica matrículas ni favoritos.

Inputs: include_archived. Returns: result

list_degree_timetablesB
Read-onlyIdempotent

Descubre horarios oficiales por curso desde la página USC de una titulación.

Inputs: degree_url (required), course_number.

list_discussion_postsD
Read-onlyIdempotent

Bloqueada: Moodle puede marcar posts; usa el flujo inspect confirmado.

Inputs: discussion_id (required), limit, offset.

list_exam_sourcesA
Read-onlyIdempotent

Muestra calendarios oficiales integrados y páginas/PDF configuradas por el usuario.

Inputs: no named parameters.

list_forum_discussionsB
Read-onlyIdempotent

Lista discusiones de cualquier foro visible, no solo los anuncios.

Inputs: forum_id (required), page, per_page.

list_forumsB
Read-onlyIdempotent

Lista todos los foros visibles de las materias seleccionadas.

Inputs: limit, offset, course_ids.

list_messagesA
Read-onlyIdempotent

Lee mensajes recibidos o enviados sin crear conversaciones ni marcarlos como leídos.

Inputs: limit, newest, offset, direction, +2 more.

list_my_badgesA
Read-onlyIdempotent

Lista únicamente las insignias visibles de la cuenta autenticada.

Inputs: page, per_page, course_id.

list_my_groupsA
Read-onlyIdempotent

Lista los grupos de la cuenta autenticada dentro de una materia.

Inputs: course_id (required).

list_notificationsA
Read-onlyIdempotent

Lista notificaciones sin marcarlas como leídas ni vaciar la cola de sesión.

Inputs: limit, offset, status.

list_official_exam_degreesC
Read-onlyIdempotent

Lista las ediciones y crosswalks institucionales admitidos para resolver exámenes.

Inputs: no named parameters.

list_official_exam_subjectsC
Read-onlyIdempotent

Descubre códigos y fichas desde los planes oficiales del curso académico exacto.

Inputs: degree_keys, academic_year.

list_pending_workC
Read-onlyIdempotent

Lista tareas, cuestionarios y acciones pendientes del Timeline de Moodle.

Inputs: days, limit, course_ids, include_overdue. Returns: result

list_quiz_attemptsC
Read-onlyIdempotent

Lista los intentos propios de un cuestionario sin modificar su estado.

Inputs: quiz_id (required), status, course_module_id, include_previews.

list_quizzesA
Read-onlyIdempotent

Lista cuestionarios visibles, fechas, límites y configuración; no inicia intentos.

Inputs: course_ids.

list_student_capabilitiesB
Read-onlyIdempotent

Cataloga APIs de alumno permitidas y, con token REST, cuáles están habilitadas.

Inputs: access, category, available_only.

list_upcoming_eventsC
Read-onlyIdempotent

Lista próximos eventos accionables del calendario del Campus.

Inputs: days, limit, course_ids. Returns: result

list_usc_degreesA
Read-onlyIdempotent

Lista las titulaciones actuales enlazadas por el catálogo público oficial USC.

Inputs: no named parameters.

locate_usc_subject_codesC
Read-onlyIdempotent

Localiza códigos G exactos en los planes oficiales de todos los grados actuales.

Inputs: academic_year (required), subject_codes (required), area_slugs, concurrency, +1 more.

mark_course_self_completedD
Destructive

Marca como completado el curso propio confirmado por Moodle y el usuario.

Inputs: course_id (required), confirmation_token (required).

preview_cancel_choice_responseA
Read-only

Previsualiza retirar todas las respuestas Choice de la cuenta actual; no cambia nada.

Inputs: choice_id (required), course_id (required).

preview_create_forum_discussionC
Read-only

Resuelve foro, permisos y audiencia; no publica la discusión ni envía avisos.

Inputs: message (required), subject (required), forum_id (required), course_id (required), +1 more.

preview_create_personal_calendar_eventC
Read-only

Previsualiza un evento personal; no crea ni modifica nada en Moodle.

Inputs: name (required), timestart (required), repeats, duration, +1 more.

preview_delete_personal_calendar_eventA
Read-only

Verifica propietario y alcance antes de borrar un evento personal; no lo borra.

Inputs: event_id (required), scope.

preview_delete_submission_filesA
Read-only

Previsualiza la eliminación de todos los archivos; conserva el texto online.

Inputs: assignment_id (required), course_module_id.

preview_finish_quizB
Read-only

Previsualiza la finalización irreversible de un intento; nunca lo envía.

Inputs: attempt_id (required), time_up, responses, preflight_data.

preview_inspect_discussion_postsC
Read-only

Previsualiza abrir posts; no consulta la discusión ni cambia su lectura.

Inputs: discussion_id (required), limit, offset.

preview_inspect_quiz_attemptB
Read-only

Previsualiza abrir un intento; no lo abre ni procesa su temporizador.

Inputs: attempt_id (required), page, summary, preflight_data.

preview_inspect_submission_statusB
Read-only

Previsualiza inspeccionar una entrega por sesion sin abrir su pagina.

Inputs: course_module_id (required).

preview_mark_course_self_completedA
Read-only

Comprueba si Moodle permite auto-completar el curso; no cambia el progreso.

Inputs: course_id (required).

preview_messageA
Read-only

Previsualiza un mensaje Moodle y crea un token; nunca realiza el envío.

Inputs: text (required), recipient_user_id (required).

preview_remove_submissionC
Read-only

Previsualiza la eliminación destructiva de toda una entrega editable.

Inputs: assignment_id (required), course_module_id.

preview_replace_submission_filesA
Read-only

Valida y previsualiza el reemplazo completo de archivos; no sube nada.

Inputs: file_paths (required), assignment_id (required), course_module_id.

preview_reply_forum_postB
Read-only

Previsualiza una respuesta pública sin adjuntos y comprueba su audiencia.

Inputs: message (required), forum_id (required), course_id (required), parent_post_id (required), +2 more.

preview_save_online_submissionB
Read-only

Previsualiza el reemplazo del texto online; nunca modifica la entrega.

Inputs: online_text (required), assignment_id (required), course_module_id.

preview_save_quiz_answersB
Read-only

Previsualiza campos y valores exactos; nunca guarda respuestas en el intento.

Inputs: responses (required), attempt_id (required), page, preflight_data.

preview_start_quizA
Read-only

Previsualiza el inicio de un intento; nunca activa el cuestionario ni su temporizador.

Inputs: quiz_id (required), force_new, preflight_data, course_module_id.

preview_student_actionC
Read-only

Previsualiza una acción estudiantil permitida; no la ejecuta ni cambia estado.

Inputs: function (required), arguments.

preview_submit_assignmentA
Read-only

Previsualiza el envío para calificación; nunca bloquea ni entrega el borrador.

Inputs: assignment_id (required), course_module_id, accept_submission_statement.

preview_submit_choice_responseB
Read-only

Resuelve textos visibles a opciones Choice; no guarda ninguna respuesta.

Inputs: choice_id (required), course_id (required), option_texts (required).

preview_update_activity_completion_status_manuallyB
Read-only

Comprueba un módulo propio con finalización manual; no cambia su estado.

Inputs: cmid (required), completed (required), course_id (required).

read_course_resourceC
Read-onlyIdempotent

Descarga por HTTP una referencia reciente y extrae texto de PDF, Office o texto.

Inputs: resource_token (required), max_bytes, max_chars, max_pdf_pages.

remove_submissionC
Destructive

Elimina una entrega completa si la versión y permisos de Moodle lo permiten.

Inputs: assignment_id (required), confirmation_token (required), course_module_id.

replace_submission_filesA
Destructive

Sube y reemplaza el conjunto de archivos exacto previamente confirmado.

Inputs: file_paths (required), assignment_id (required), confirmation_token (required), course_module_id.

reply_forum_postC
Destructive

Publica la respuesta pública exacta aprobada mediante una vista previa reciente.

Inputs: message (required), forum_id (required), course_id (required), parent_post_id (required), +3 more.

save_online_submissionC
Destructive

Reemplaza el texto online por el contenido exacto previamente confirmado.

Inputs: online_text (required), assignment_id (required), confirmation_token (required), course_module_id.

save_quiz_answersC
Destructive

Guarda las respuestas exactas ya previsualizadas sin finalizar el intento.

Inputs: responses (required), attempt_id (required), confirmation_token (required), page, +1 more.

search_exam_datesC
Read-onlyIdempotent

Busca evidencias de fechas en páginas/PDF oficiales USC y conserva URL/página.

Inputs: query, source_urls, max_documents.

search_message_contactsA
Read-onlyIdempotent

Busca destinatarios de mensajería Moodle y devuelve IDs; no envía nada.

Inputs: query (required), limit. Returns: result

send_messageA
Destructive

Envía el mensaje exacto previsualizado; exige aprobación humana y token de un solo uso.

Inputs: text (required), recipient_user_id (required), confirmation_token (required).

start_quizC
Destructive

Inicia el intento previsualizado; puede activar inmediatamente un temporizador.

Inputs: quiz_id (required), confirmation_token (required), force_new, preflight_data, +1 more.

submit_assignmentC
Destructive

Envía para calificación el borrador previamente revisado y confirmado.

Inputs: assignment_id (required), confirmation_token (required), course_module_id, accept_submission_statement.

submit_choice_responseC
Destructive

Guarda únicamente las opciones Choice exactas aprobadas en la vista previa.

Inputs: choice_id (required), course_id (required), option_texts (required), confirmation_token (required).

update_activity_completion_status_manuallyC
Destructive

Marca o desmarca la finalización manual del módulo propio confirmado.

Inputs: cmid (required), completed (required), course_id (required), confirmation_token (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.7/5.0

    Scored across 91 tools

    Disambiguation3/5

    Some tool clusters overlap meaningfully, such as submission status (get/inspect/preview_inspect), calendar/timeline reads (list_calendar_events, list_upcoming_events, list_pending_work, get_work_item), and the generic preview_student_action/execute_student_action versus specific action tools. The detailed descriptions help, but with 91 tools an agent must read carefully to avoid misselection.

    Naming Consistency4/5

    The vast majority of tools follow a clear snake_case verb_noun pattern, and the preview_/action pairing is highly consistent. Minor deviations like auth_status and generic names like execute_student_action and call_student_read break the strict pattern slightly, but the overall scheme remains predictable.

    Tool Count1/5

    91 tools is an extreme count for a single MCP server. Many tools are paired preview/action variants, compatibility stubs, or blocked endpoints that could be consolidated, making the surface far larger than necessary and difficult to navigate.

    Completeness5/5

    The server covers a broad student-facing lifecycle end-to-end: courses, assignments, quizzes, forums, messaging, calendar, grades, completion, badges, notifications, and official USC timetables/exams. Even blocked tools have explicit alternative flows, so there are no major workflow dead-ends.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Enables querying courses, assignments, deadlines, and materials from the UNAM Moodle virtual classroom, as well as downloading files and submitting assignments through natural language.
      8
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI assistants to query the UEx virtual campus (CVUEx/AVUEx) in natural language, including deadlines, grades, announcements, forums, and course materials, using the user's own account with read-only access.
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Provides read-only access to a university's Moodle virtual campus, letting an AI assistant browse courses, sections and files, check upcoming deadlines, view assignment status and grades, and read forum announcements and threads. Authentication uses a Moodle token stored locally, with support for both undergraduate and postgraduate campus URLs.
      8
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Connects AI agents to Argentine universities' Moodle virtual classrooms and SIU Guaraní self-service portals, enabling them to read course materials, announcements, grades, and enrollment data. With user confirmation it can also post to forums, submit assignments, answer choices, and send private messages.
      340 npm
      1
      MIT