mcp-usc
mcp-usc is a local MCP server that lets a USC student’s AI assistant interact with their Moodle Campus Virtual and public USC academic sources, using only the student’s own permissions and requiring confirmation for any write/state-changing action.
Campus overview: check auth status, view profile/preferences, list courses, pending work, upcoming events, announcements, calendar events, grades, completion, badges, private files, participants, and groups.
Messages and forums: read received/sent messages and conversation messages, search contacts, preview and send messages, list forums and discussions, and create forum discussions or reply after explicit confirmation.
Course materials and resources: list course contents and downloadable resources, read PDF/Office/text resources via secure local references, and manage resource downloads with size/page limits.
Assignments: list assignments, check submission status/reopen eligibility, and after preview+confirmation save online text, replace/delete submission files, submit for grading, or remove an editable submission.
Quizzes: list quizzes and own attempts, read final reviews/best grade, and after preview+confirmation inspect, start, save answers to, or finish an attempt.
Choice activities: preview and submit or cancel your own Choice responses after confirmation.
Student capability catalog: list allowed student APIs, call whitelisted read-only Moodle functions, and preview/execute permitted generic student actions with confirmation tokens.
Public USC academic sources: browse USC degrees, discover degree timetables, fetch class timetables, locate official subject codes, list official exam degrees/subjects, get official exam dates, and cross-reference them with your Moodle courses.
Safety model: reads are read-only, all effectful operations require a fresh one-use confirmation token and host approval, uploads are restricted to an allowlisted local folder, and ambiguous network outcomes are never auto-retried.
Provides tools for interacting with a University of Santiago de Compostela Moodle campus: listing courses, pending work, upcoming events, work items and announcements, searching message contacts, previewing and sending Moodle messages, and looking up exam dates from configured official USC pages and PDFs.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-usc What assignments do I have pending on Campus Virtual?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
MoodleSessioncookie, reads use same-origin AJAX and direct/pluginfile.phpdownloads. 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;
uvrecommended;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 devThis 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 chromiumThe 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:
Official REST if
USC_MOODLE_TOKENorUSC_MOODLE_TOKEN_FILEprovides a token.HTTP with the
MoodleSessioncookie stored bykeyring.
REST token
Use only a legitimate token issued by Moodle for your account and service:
$env:USC_MOODLE_TOKEN = "..."
uv run mcp-usc statusIt 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.
Cookie session
uv run mcp-usc login
uv run mcp-usc statusComplete 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.phpprovides the identity and the ephemeralsesskeywithout opening the dashboard;/lib/ajax/service.phpexecutes functions marked as AJAX;reads fail closed if Moodle does not publish them via AJAX;
authenticated downloads keep the cookie, accept only direct
/pluginfile.phpand 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 |
Reading and modifying assignments | REST | Not safely available |
Submission files | REST + | The JavaScript |
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_BYTESapplies to both each file and the total;default value: 50 MiB (
52428800bytes);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 listTo 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 serveRestart 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 |
|
|
|
Campus and calendar |
| create or delete a personal event | create or delete a personal event |
Messages and forums |
| 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 |
| — | — |
Assignments |
|
|
|
Quizzes |
| 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_messagesreads received or sent messages without marking them.list_conversationsis 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 whylist_discussion_postsfails closed and thepreview_inspect_discussion_posts/inspect_discussion_postspair requires confirmation before traversing posts and attachment metadata.search_message_contactscreates a temporary reference to the recipient.preview_messagerequires a recent search, shows name, ID, and text, and never sends.list_course_contentslists sections, activities, pages, links, and files.list_course_resourcesreturns opaque references valid for ten minutes. Only a recent reference can be used withread_course_resource.read_course_resourcesupports 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; openingcourse/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_assignmentcan close draft editing and must respect the submission statement that Moodle shows.remove_submissionusesmod_assign_remove_submission, available in Moodle 4.5 or later. It is destructive and is not equivalent to "reopening."check_submission_reopennever 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_pageandget_quiz_attempt_summaryfail closed;preview_inspect_quiz_attemptshows the risk andinspect_quiz_attemptrequires 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_quizcan immediately activate a timer.save_quiz_answersmodifies an open attempt but does not finish it.finish_quizis 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:
preview_*validates the state and returns the visible parameters plus aconfirmation_token.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:
Moodle External Services and their security recommendations.
Moodle 4.5 definitions for messaging, forums, contents, assignments and quizzes from the official GPL-3.0 repository.
moodlehq/moodleapp(Apache-2.0), official reference for using services, contents and resources from a client.
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:
haolamnm/moodle-mcp-srv(Apache-2.0): architecture, diagnostics and REST client.Snaw80/moodle-mcp(MIT): SSO login and mobile flow. The USC public mobile endpoint returns 404, so a locally obtained cookie is used instead.GhaithAlHallak8/moodler-mcp(MIT): Moodle session and same-origin AJAX.1alexandrer/moodle-mcp(MIT): student-oriented tools and actionable events.mrcinv/moodle_api.py(MIT): generic client andcore_course_get_contents.lmscloud-io/moodle-mcp-server(GPL-3.0): MCP exposure of Moodle functions with least privilege.
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
MoodleSessionexpire;mcp-usc loginmust 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
filemanageris 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 toolsauth_statusARead-onlyIdempotent
Comprueba si la sesión local/token del Campus funciona, sin devolver secretos.
Inputs: no named parameters.
call_student_readCRead-onlyIdempotent
Ejecuta una función Moodle incluida explícitamente en la lista blanca de lecturas.
Inputs: function (required), arguments.
cancel_choice_responseCDestructive
Retira solo las respuestas Choice propias aprobadas en la vista previa reciente.
Inputs: choice_id (required), course_id (required), confirmation_token (required).
check_submission_reopenCRead-onlyIdempotent
Comprueba si el alumno puede seguir editando; nunca usa privilegios de profesor.
Inputs: assignment_id (required), course_module_id.
create_forum_discussionCDestructive
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_eventBDestructive
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_eventCDestructive
Borra solo el evento personal o serie exactos aprobados en la vista previa.
Inputs: event_id (required), confirmation_token (required), scope.
delete_submission_filesCDestructive
Elimina todos los archivos de una entrega editable tras confirmación.
Inputs: assignment_id (required), confirmation_token (required), course_module_id.
describe_mcp_uscARead-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_actionBDestructive
Ejecuta la acción Moodle exacta aprobada mediante una previsualización reciente.
Inputs: function (required), arguments (required), confirmation_token (required).
finish_quizCDestructive
Finaliza el intento exacto ya previsualizado; normalmente es irreversible.
Inputs: attempt_id (required), confirmation_token (required), time_up, responses, +1 more.
get_degree_class_timetableCRead-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_timetableARead-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_completionBRead-onlyIdempotent
Consulta progreso y finalización propios sin marcar actividades como completadas.
Inputs: course_id (required).
get_my_gradesARead-onlyIdempotent
Lee las calificaciones propias globales o de una materia; no registra visita al informe.
Inputs: course_id.
get_my_official_exam_scheduleBRead-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_preferencesARead-onlyIdempotent
Lee preferencias propias; no cambia idioma, avisos ni configuración de mensajes.
Inputs: name.
get_my_profileARead-onlyIdempotent
Lee el perfil de la cuenta autenticada sin registrar una visita al perfil.
Inputs: no named parameters.
get_official_exam_datesCRead-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_infoARead-onlyIdempotent
Consulta cuotas y recuentos de archivos privados; no crea borradores ni descarga nada.
Inputs: no named parameters.
get_quiz_attempt_pageDRead-onlyIdempotent
Bloqueada: Moodle puede cambiar el intento al leer; usa el flujo inspect confirmado.
Inputs: attempt_id (required), page, preflight_data.
get_quiz_attempt_reviewARead-onlyIdempotent
Lee la revisión permitida de un intento finalizado sin registrar una visita.
Inputs: attempt_id (required), page.
get_quiz_attempt_summaryDRead-onlyIdempotent
Bloqueada: Moodle puede procesar un timeout; usa el flujo inspect confirmado.
Inputs: attempt_id (required), preflight_data.
get_quiz_best_gradeCRead-onlyIdempotent
Consulta la mejor calificación propia que Moodle permite mostrar para un cuestionario.
Inputs: quiz_id (required).
get_submission_statusBRead-onlyIdempotent
Consulta borrador, archivos, texto, feedback y permisos actuales de una entrega.
Inputs: assignment_id (required), course_module_id.
get_work_itemARead-onlyIdempotent
Obtiene el detalle visible de un evento/tarea por su identificador Moodle.
Inputs: event_id (required).
inspect_discussion_postsCDestructive
Lee posts confirmados; Moodle puede marcarlos como leídos y registrar seguimiento.
Inputs: discussion_id (required), confirmation_token (required), limit, offset.
inspect_quiz_attemptDDestructive
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_announcementsCRead-onlyIdempotent
Lee avisos recientes de los foros de novedades/anuncios de las materias.
Inputs: limit, course_ids, since_days. Returns: result
list_assignmentsBRead-onlyIdempotent
Lista tareas configuradas en Moodle, incluidos plazos y tipos de entrega.
Inputs: course_ids.
list_calendar_eventsBRead-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_messagesBRead-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_conversationsDRead-onlyIdempotent
Compatibilidad: falla cerrado; usa list_messages para evitar un write oculto de Moodle.
Inputs: limit, offset, favourites, conversation_type.
list_course_contentsARead-onlyIdempotent
Lista secciones, actividades, páginas, enlaces y archivos visibles de una materia.
Inputs: course_id (required), limit, offset, section_id.
list_course_participantsARead-onlyIdempotent
Lista únicamente los participantes que Moodle permite ver en una materia.
Inputs: course_id (required), limit, offset.
list_course_resourcesCRead-onlyIdempotent
Lista archivos descargables y crea referencias locales seguras para leerlos.
Inputs: course_id (required), limit, offset, section_id.
list_coursesARead-onlyIdempotent
Lista las materias del usuario. No modifica matrículas ni favoritos.
Inputs: include_archived. Returns: result
list_degree_timetablesBRead-onlyIdempotent
Descubre horarios oficiales por curso desde la página USC de una titulación.
Inputs: degree_url (required), course_number.
list_discussion_postsDRead-onlyIdempotent
Bloqueada: Moodle puede marcar posts; usa el flujo inspect confirmado.
Inputs: discussion_id (required), limit, offset.
list_exam_sourcesARead-onlyIdempotent
Muestra calendarios oficiales integrados y páginas/PDF configuradas por el usuario.
Inputs: no named parameters.
list_forum_discussionsBRead-onlyIdempotent
Lista discusiones de cualquier foro visible, no solo los anuncios.
Inputs: forum_id (required), page, per_page.
list_forumsBRead-onlyIdempotent
Lista todos los foros visibles de las materias seleccionadas.
Inputs: limit, offset, course_ids.
list_messagesARead-onlyIdempotent
Lee mensajes recibidos o enviados sin crear conversaciones ni marcarlos como leídos.
Inputs: limit, newest, offset, direction, +2 more.
list_my_badgesARead-onlyIdempotent
Lista únicamente las insignias visibles de la cuenta autenticada.
Inputs: page, per_page, course_id.
list_my_groupsARead-onlyIdempotent
Lista los grupos de la cuenta autenticada dentro de una materia.
Inputs: course_id (required).
list_notificationsARead-onlyIdempotent
Lista notificaciones sin marcarlas como leídas ni vaciar la cola de sesión.
Inputs: limit, offset, status.
list_official_exam_degreesCRead-onlyIdempotent
Lista las ediciones y crosswalks institucionales admitidos para resolver exámenes.
Inputs: no named parameters.
list_official_exam_subjectsCRead-onlyIdempotent
Descubre códigos y fichas desde los planes oficiales del curso académico exacto.
Inputs: degree_keys, academic_year.
list_pending_workCRead-onlyIdempotent
Lista tareas, cuestionarios y acciones pendientes del Timeline de Moodle.
Inputs: days, limit, course_ids, include_overdue. Returns: result
list_quiz_attemptsCRead-onlyIdempotent
Lista los intentos propios de un cuestionario sin modificar su estado.
Inputs: quiz_id (required), status, course_module_id, include_previews.
list_quizzesARead-onlyIdempotent
Lista cuestionarios visibles, fechas, límites y configuración; no inicia intentos.
Inputs: course_ids.
list_student_capabilitiesBRead-onlyIdempotent
Cataloga APIs de alumno permitidas y, con token REST, cuáles están habilitadas.
Inputs: access, category, available_only.
list_upcoming_eventsCRead-onlyIdempotent
Lista próximos eventos accionables del calendario del Campus.
Inputs: days, limit, course_ids. Returns: result
list_usc_degreesARead-onlyIdempotent
Lista las titulaciones actuales enlazadas por el catálogo público oficial USC.
Inputs: no named parameters.
locate_usc_subject_codesCRead-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_completedDDestructive
Marca como completado el curso propio confirmado por Moodle y el usuario.
Inputs: course_id (required), confirmation_token (required).
preview_cancel_choice_responseARead-only
Previsualiza retirar todas las respuestas Choice de la cuenta actual; no cambia nada.
Inputs: choice_id (required), course_id (required).
preview_create_forum_discussionCRead-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_eventCRead-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_eventARead-only
Verifica propietario y alcance antes de borrar un evento personal; no lo borra.
Inputs: event_id (required), scope.
preview_delete_submission_filesARead-only
Previsualiza la eliminación de todos los archivos; conserva el texto online.
Inputs: assignment_id (required), course_module_id.
preview_finish_quizBRead-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_postsCRead-only
Previsualiza abrir posts; no consulta la discusión ni cambia su lectura.
Inputs: discussion_id (required), limit, offset.
preview_inspect_quiz_attemptBRead-only
Previsualiza abrir un intento; no lo abre ni procesa su temporizador.
Inputs: attempt_id (required), page, summary, preflight_data.
preview_inspect_submission_statusBRead-only
Previsualiza inspeccionar una entrega por sesion sin abrir su pagina.
Inputs: course_module_id (required).
preview_mark_course_self_completedARead-only
Comprueba si Moodle permite auto-completar el curso; no cambia el progreso.
Inputs: course_id (required).
preview_messageARead-only
Previsualiza un mensaje Moodle y crea un token; nunca realiza el envío.
Inputs: text (required), recipient_user_id (required).
preview_remove_submissionCRead-only
Previsualiza la eliminación destructiva de toda una entrega editable.
Inputs: assignment_id (required), course_module_id.
preview_replace_submission_filesARead-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_postBRead-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_submissionBRead-only
Previsualiza el reemplazo del texto online; nunca modifica la entrega.
Inputs: online_text (required), assignment_id (required), course_module_id.
preview_save_quiz_answersBRead-only
Previsualiza campos y valores exactos; nunca guarda respuestas en el intento.
Inputs: responses (required), attempt_id (required), page, preflight_data.
preview_start_quizARead-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_actionCRead-only
Previsualiza una acción estudiantil permitida; no la ejecuta ni cambia estado.
Inputs: function (required), arguments.
preview_submit_assignmentARead-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_responseBRead-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_manuallyBRead-only
Comprueba un módulo propio con finalización manual; no cambia su estado.
Inputs: cmid (required), completed (required), course_id (required).
read_course_resourceCRead-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_submissionCDestructive
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_filesADestructive
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_postCDestructive
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_submissionCDestructive
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_answersCDestructive
Guarda las respuestas exactas ya previsualizadas sin finalizar el intento.
Inputs: responses (required), attempt_id (required), confirmation_token (required), page, +1 more.
search_exam_datesCRead-onlyIdempotent
Busca evidencias de fechas en páginas/PDF oficiales USC y conserva URL/página.
Inputs: query, source_urls, max_documents.
search_message_contactsARead-onlyIdempotent
Busca destinatarios de mensajería Moodle y devuelve IDs; no envía nada.
Inputs: query (required), limit. Returns: result
send_messageADestructive
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_quizCDestructive
Inicia el intento previsualizado; puede activar inmediatamente un temporizador.
Inputs: quiz_id (required), confirmation_token (required), force_new, preflight_data, +1 more.
submit_assignmentCDestructive
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_responseCDestructive
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_manuallyCDestructive
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
Scored across 91 tools
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.
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.
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.
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
Related MCP Connectors
Search university course materials, your flashcards, quizzes, streak and quota. All tools read-only.
Read your plat.plus courses, tasks, course pages, sessions, files and messages. Read-only.
Your Telegram, WhatsApp, Instagram, mail and calendar in Claude or ChatGPT. Never sends messages.
PLATO (Pusan National University LMS) MCP server via Moodle Web Service API + ubboard scraping
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables querying courses, assignments, deadlines, and materials from the UNAM Moodle virtual classroom, as well as downloading files and submitting assignments through natural language.8MIT
- AlicenseNot gradedqualityBmaintenanceEnables 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
- AlicenseAqualityCmaintenanceProvides 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.8MIT
- AlicenseNot gradedqualityBmaintenanceConnects 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 npm1MIT