Campus Virtual MCP
This MCP server lets an AI assistant authenticate to the UTN FRSF Campus Virtual and perform permission-scoped campus discovery, download, and assignment-submission workflows.
get_server_info: read server version, timezone, registered tools, verification status, and known limits.login: authenticate with local.envcredentials, retain the campus session, and retry bounded TooManyRequests errors.list_monthly_activities: list visible monthly calendar activities with course, ISO dates, activity links, and optional deadlines-only filtering.list_courses: list visible Grado courses with IDs, names, and URLs; incomplete extraction errors rather than returning an empty list.get_course_resources: inventory accessible course links/resources, including files, assignments, folders, sections, modules, and completeness warnings.download_resources: download 1–10 campus files to localdownloads/paths, verifying HTTP response, size, SHA-256, and login/error pages.prepare_submission: validate local files and compute hashes without logging in or writing to the campus.get_submission_status: inspect an assignment’s state, editable status, submitted files, source URL, and evidence.upload_files: upload files to a temporary assignment area within activity limits and return a short-lived receipt; does not save or submit.submit_assignment: save and optionally finalize an authorized submission, verify the campus result, and accept authorship statements only when explicitly requested.
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., "@Campus Virtual MCP ¿Qué trabajos prácticos vencen esta semana?"
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.
UTN FRSF · Campus Virtual MCP
Un servidor MCP para conectar asistentes de inteligencia artificial con el Campus Virtual de la UTN Facultad Regional Santa Fe.
Su objetivo es facilitar las tareas cotidianas del estudiante desde un asistente, usando su cuenta del campus.
Proyecto en desarrollo. Incluye inicio de sesión, consulta mensual de actividades y listado de enlaces por asignatura y flujo de carga/entrega de tareas. La carga y entrega se verificaron en una tarea real autorizada.
login() usa las credenciales del .env privado. list_monthly_activities() devuelve JSON con las fechas, horarios, asignaturas y enlaces directos de las actividades del calendario. Podés probarlas en Inspector siguiendo la guía de desarrollo. Los parámetros y ejemplos de la consulta mensual están en su guía.
list_courses() devuelve las materias visibles en Grado, con ID, nombre y enlace, incluidos años anteriores. Permite encontrar la materia antes de consultar recursos o entregas. Ver alcance y verificación.
get_course_resources(course_id) lista los enlaces de una materia, incluidas tareas, archivos y materiales de carpetas. Recorre secciones y devuelve el alcance de la consulta. Ver uso y límites; verificada en Análisis Numérico (topics); queda pendiente la validación integral de onetopic.
get_section_content(course_id, section), get_page_content(course_id, module_id) y get_folder_content(course_id, module_id) leen como Markdown el texto publicado en secciones, páginas y descripciones de carpetas, incluidas tablas como los cronogramas.
download_resources(course_id, module_id, urls) descarga archivos de cualquier tipo del módulo indicado a downloads/, valida la transferencia y devuelve rutas, tamaños y hashes. Ver uso y límites.
get_server_info() indica qué herramientas están verificadas en el campus, cuáles solo parcialmente y cuáles tienen solo pruebas locales, con sus límites conocidos.
get_assignment_feedback() muestra la devolución del docente en una tarea: nota, fecha, quién corrigió, comentarios y archivos devueltos.
get_submission_status() consulta una tarea; prepare_submission() valida archivos localmente; upload_files() los carga a un área temporal; submit_assignment() guarda y, opcionalmente, finaliza la entrega. Ver contrato y verificación. La carga y el guardado se verificaron mediante MCP en el TP 6 de Análisis Numérico, con estado final enviado y comprobación de los bytes.
Funciones previstas
Consultar materias, actividades y consignas.
Revisar fechas de entrega y eventos del calendario.
Descargar bibliografía, apuntes y otros materiales.
Enviar trabajos prácticos, consultar el estado de las entregas y leer sus devoluciones.
Related MCP server: cvuex-mcp
Cómo funciona
El asistente recibe un pedido en lenguaje natural, como “¿qué trabajos vencen esta semana?” o “descargá la bibliografía de esta materia”. A través de MCP, solicita las acciones necesarias al servidor.
El servidor utiliza Lightpanda, un navegador que funciona en segundo plano, para acceder al campus, consultar información o realizar la acción solicitada. Luego devuelve el resultado al asistente.
El acceso se limita a las materias y recursos disponibles para la cuenta del estudiante.
Estructura
src/utnfrsf_campus_mcp/
├── server.py # Arranque del servidor MCP.
├── config.py # Configuración desde .env y variables de entorno.
├── models.py # Modelos de datos.
├── browser/ # Integración con Lightpanda.
├── parsers/ # Extracción de información del campus.
├── services/ # Lógica de las funcionalidades.
└── tools/ # Herramientas expuestas al asistente.
docs/ # Documentación de desarrollo.
examples/ # Ejemplos de configuración MCP.
.env.example # Plantilla de configuración local.
pyproject.toml # Paquete y dependencias.
uv.lock # Versiones de dependencias.
roadmap.md # Plan de implementación.
AGENTS.md # Guía para agentes de desarrollo.Documentación técnica: desarrollo local · roadmap · análisis y funcionalidades pendientes.
Licencia
MIT. Proyecto independiente, sin afiliación oficial con la UTN.
Available Tools
10 toolsdownload_resourcesA
Descarga entre 1 y 10 archivos del campus a downloads/course-ID/module-ID/.
Verifica su pertenencia al módulo y a la materia con una consulta autenticada nueva. Usa la sesión de Lightpanda y un transporte HTTP binario del mismo origen. Valida respuesta HTTP y tamaño; calcula SHA-256 y detecta páginas de login/error de Moodle. Admite cualquier extensión y MIME; no valida el formato interno ni ejecuta archivos. No sigue redirecciones ni reemplaza archivos existentes. Devuelve rutas locales, tamaños, hashes y fallos por archivo. Solo archivos del campus, sin destinos externos. No modifica entregas del campus.
Inputs: urls (required), course_id (required), module_id (required). Returns: files, course, complete, failures, +1 more
get_course_resourcesARead-onlyIdempotent
Lista los enlaces de una asignatura, incluidas tareas y archivos PDF, ZIP y otros.
Recorre secciones topics/onetopic accesibles; lee carpetas, recursos, enlaces URL, páginas y adjuntos de consignas de tareas. Devuelve links con sección, módulo y source_url. Los enlaces de tareas abren la actividad de entrega; no envía archivos. Autentica con .env. No visita sitios externos ni descarga binarios. Solo contenido visible para la cuenta: no inventa enlaces de actividades o secciones restringidas. Revisá complete, pending_urls y warnings antes de asumir que el inventario es completo. No recorre conversaciones de foros, intentos de exámenes ni sitios externos.
Inputs: course_id (required). Returns: Inventario de enlaces del curso y alcance efectivo de la consulta.
get_server_infoARead-onlyIdempotent
Consulta versión, zona horaria y el estado real de cada herramienta registrada.
No abre Lightpanda ni verifica la sesión del campus. Cada elemento de capabilities indica efecto (none, local, read, write), nivel de evidencia (local_tests, campus_partial, campus_verified), fecha de verificación real, alcance, límites pendientes, IDs relacionados del inventario y documentación. undocumented_tools lista herramientas registradas sin estado declarado.
Inputs: no named parameters. Returns: Información pública del servidor, sin probar acceso al campus.
get_submission_statusBRead-onlyIdempotent
Consulta estado y archivos de una tarea assign, conservando la evidencia original.
Inputs: course_id (required), activity_id (required). Returns: name, files, state, can_edit, +4 more
list_coursesARead-onlyIdempotent
Lista las materias visibles en My courses → Grado, con ID, nombre completo y URL.
Sin parámetros. Autentica con la configuración privada de .env y comparte la sesión de Lightpanda con las demás herramientas. Incluye Sistemas y Básicas y todos los años presentes en esa rama; excluye Ingreso, Extensión y el catálogo general. Devuelve scope=Grado, source_url, fetched_at, total, courses y complete=true. Una rama pendiente, un límite o un fallo de sesión/parsing producen un error MCP, nunca una lista vacía exitosa. No abre cada materia ni modifica datos académicos. Los nombres parecidos se devuelven como materias distintas con sus respectivos IDs.
Inputs: no named parameters. Returns: Materias visibles en Grado; una extracción incompleta produce un error.
list_monthly_activitiesARead-onlyIdempotent
Lista en JSON las actividades del calendario mensual de todas las asignaturas.
Omití year y month para consultar el mes actual en la zona del campus, o indicá ambos. Incluye nombre, asignatura, fechas ISO 8601 con hora y offset, y activity_url directo. deadline_at solo se completa para due/close; aperturas y asistencias conservan su tipo. No confirma entregas pendientes. Autentica con .env y consulta solo eventos visibles para la cuenta y sus filtros de calendario. No depende del idioma de la interfaz.
Inputs: year, month, deadlines_only. Returns: Calendario del mes visible para la cuenta; no confirma el estado de entrega.
loginA
Inicia sesión en UTN FRSF con las credenciales locales de .env.
Conserva la sesión durante la ejecución del servidor. Reintenta TooManyRequests de forma acotada, volviendo a la página de acceso.
Inputs: no named parameters. Returns: Confirmación de sesión; no contiene identidad, tokens ni credenciales.
prepare_submissionBRead-onlyIdempotent
Prepara archivos y hashes localmente; no inicia sesión ni escribe en el campus.
Inputs: files (required), course_id (required), activity_id (required). Returns: files, course_id, activity_id
submit_assignmentA
Guarda la carga del recibo como entrega y verifica el resultado en el campus.
Guardar puede entregar definitivamente si la actividad no utiliza borradores. finalize=true completa además la confirmación de envío cuando exista. Una declaración de autoría requiere accept_statement=true explícito. No reemplaza entregas existentes ni reenvía POSTs de resultado incierto. Solo invocar para una entrega autorizada con esos archivos y destino; upload_files por sí sola no autoriza este guardado.
Inputs: upload_id (required), finalize, accept_statement. Returns: stage, status, message, upload_id, +1 more
upload_filesA
Carga y verifica archivos en el área temporal de una tarea abierta; devuelve un recibo.
Respeta los tipos, tamaños y cantidad admitidos por la actividad. Admite archivos de cualquier tipo permitido, incluidos ZIP; rechaza carpetas y reemplazos de entregas. No guarda ni envía la entrega. El recibo dura 30 minutos en este proceso MCP.
Inputs: files (required), course_id (required), activity_id (required). Returns: files, stage, limits, message, +4 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Most tools target distinct resources and actions, and the submission pipeline (prepare_submission → upload_files → submit_assignment) is explicitly delineated, with descriptions stating that upload alone does not submit and prepare doesn't touch the campus. The only mild overlaps are download_resources vs get_course_resources (list links vs fetch binaries) and prepare_submission vs upload_files, both of which are clarified in the descriptions.
All names are snake_case and almost all follow a verb_noun pattern (list_courses, get_course_resources, download_resources, submit_assignment). The single outlier is the bare verb 'login' with no object, which is a minor, natural deviation and does not harm readability.
Ten tools is squarely in the well-scoped range, and each one earns its place: session setup, course/calendar inventory, resource discovery and download, plus a four-step staged submission workflow. There is no filler or redundancy.
The surface covers the core lifecycle: login, list courses, discover resources, download files, read calendar deadlines, and a full prepare/status/upload/submit pipeline with verification. Minor gaps exist — no logout/session-state tool beyond get_server_info, no grades or notification/announcement retrieval, and no assignment-detail lookup — but these are described as intentional scope limits rather than dead ends for the main workflows.
Maintenance
Related MCP Connectors
Connect AI assistants to Edusign attendance, courses, learners, documents, and API docs via OAuth.
Connect assistants to your workspace knowledge, skills, and work tools.
Create, edit, translate, and export SCORM eLearning modules from a connected AI assistant.
Connect AI assistants to Stellary projects, boards, documents, and governed agent workflows.
Related MCP Servers
- FlicenseNot gradedqualityBmaintenanceEnables AI assistants to interact with a student's Canvas LMS account, supporting course viewing, grade checks, assignment submissions, announcements, discussions, calendar events, inbox messages, and more via specialized tools.1-
- 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
- AlicenseAqualityCmaintenanceEnables AI tools to read course materials, links, and deadlines from a student's university learning platform, and to download lecture slides into course folders for SlideMate and other MCP clients.82MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to access and manage academic course information, assignments, submissions, grades, calendars, materials, recordings, and announcements through authenticated LMS sessions.MIT