Brightspace Facultad MCP
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., "@Brightspace Facultad MCP Listá mis materias y las actividades de Aplicaciones Interactivas."
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.
Brightspace Facultad MCP
Consultá materias, actividades, consignas, noticias y materiales de Brightspace UADE desde un asistente MCP. Corre en tu computadora con tu cuenta y un Chromium dedicado, como Teams Facultad MCP, del que reutiliza infraestructura bajo licencia MIT.
Instalar con mi agente de IA · Descargar la última versión · Reportar un problema
Instalá con tu agente de IA
Pegá este prompt en un agente con acceso a la terminal de tu computadora (por ejemplo, Codex, Claude Code o Cursor):
Instalá y conectá el MCP local de este repositorio:
https://github.com/Matias-Sanmiguel/brightspace-facultad-mcp
Leé INSTALL_WITH_AI.md y seguí su prompt de instalación completo.
USE AT YOUR OWN RISK: acepto usar este proyecto bajo mi propia responsabilidad.
Prepará el entorno, ejecutá el instalador y configurá mi cliente MCP.
Yo voy a completar el inicio de sesión de UADE y MFA en el navegador dedicado.
Verificá el resultado y avisame si el cliente necesita reiniciarse.El prompt completo incluye instalación por sistema, conservación de la configuración existente y comprobación de la conexión. Cada persona instala su copia e inicia sesión con su propia cuenta.
Related MCP server: canvas-session-mcp
Instalación
Necesitás Python 3.11+, Internet y un cliente MCP con transporte stdio.
Descargá brightspace-facultad-mcp-0.1.0-source.zip desde
Releases
y extraelo en una carpeta permanente. También podés clonar el repositorio:
git clone https://github.com/Matias-Sanmiguel/brightspace-facultad-mcp.git
cd brightspace-facultad-mcpAbrí una terminal en esa carpeta y ejecutá los comandos de tu sistema:
Linux / macOS
sh install.sh
.venv/bin/python -m brightspace_facultad_mcp loginWindows — PowerShell
py -3 scripts/install.py
& .\.venv\Scripts\python.exe -m brightspace_facultad_mcp loginEl instalador crea .venv, instala dependencias fijadas con hashes desde PyPI,
descarga Chromium y genera mcp-config.json con las rutas de tu equipo.
En Linux, si Playwright informa bibliotecas faltantes, seguí su diagnóstico de
dependencias de sistema.
Completá el ingreso y MFA de UADE en la ventana del navegador. Al confirmar
la sesión, el comando cierra el navegador y libera el perfil para el MCP.
Copiá la entrada brightspace-facultad de mcp-config.json a tu cliente
conservando sus otros servidores. Para Codex, el formato correspondiente es:
[mcp_servers.brightspace-facultad]
command = "/RUTA/brightspace-facultad-mcp/.venv/bin/python"
args = ["-m", "brightspace_facultad_mcp", "serve"]
startup_timeout_sec = 30
tool_timeout_sec = 180
[mcp_servers.brightspace-facultad.env]
BRIGHTSPACE_MCP_HEADLESS = "1"En Windows, command termina en .venv\\Scripts\\python.exe; usá las rutas
reales que genera config. Si el JSON incluye variables gráficas, trasladalas
también al bloque env. Recargá los servidores o reiniciá el cliente.
Configuración oficial de MCP en Codex.
Herramientas
Herramienta | Consulta |
| Navegador y estado del ingreso; no abre Chromium por sí sola |
| Abre el ingreso si el servidor funciona en modo visible |
| Cursos visibles en Mis cursos |
| Actividades de una materia: estado, fecha original y puntuación visible |
| Consigna y referencias a adjuntos; avisa si la actividad cerrada solo permite ver un resumen |
| Noticias de una materia y sus textos; predeterminado 10 por página |
| Unidades, módulos y temas de Contenido |
| Texto de HTML, PDF, DOCX y PPTX, por fragmentos |
Ejemplos:
Listá mis materias de Brightspace y las actividades de Aplicaciones Interactivas.
Leé la consigna de la actividad y las últimas dos noticias de la materia.
Buscá en los módulos el apunte de React y resumilo indicando la fuente.
Los IDs y cursores se obtienen de resultados anteriores y vencen al reiniciar.
Usá materia_id al consultar tareas, noticias y materiales; carpeta_id permite
entrar a un módulo. Si hay cursor, repetí la misma consulta con ese cursor.
Las fechas se conservan como aparecen en la plataforma; no se inventan fechas
para tareas que no las muestran.
Sesión local
El perfil se guarda fuera del proyecto, en el directorio de datos de tu usuario
(~/.local/share/brightspace-facultad-mcp en Linux por defecto). Cada alumno
instala su copia e ingresa con su propia cuenta. No se usa el perfil de Teams
ni el navegador cotidiano. Un solo proceso puede usar el perfil a la vez.
El cliente usa BRIGHTSPACE_MCP_HEADLESS=1 para consultar sin ventana. Si la
sesión vence, cerrá el cliente MCP, ejecutá login en una terminal gráfica y
reabrí el cliente. El comando login necesita modo visible: no lo ejecutes con
BRIGHTSPACE_MCP_HEADLESS=1. Para diagnóstico podés cambiar esa variable a 0.
BRIGHTSPACE_MCP_DATA_DIR permite elegir un directorio de perfil independiente.
.venv/bin/python -m brightspace_facultad_mcp doctor
.venv/bin/python -m brightspace_facultad_mcp configNo compartas el perfil ni mcp-config.json. Los resultados enviados a tu
asistente quedan sujetos a la configuración del cliente y su proveedor de IA.
Alcance
Las herramientas consultan: no envían mensajes, entregan trabajos ni responden cuestionarios. Abrir un tema puede actualizar el progreso de lectura y abrir noticias puede marcarlas como leídas. No se usan endpoints internos ni se interceptan tokens. Los enlaces de lectura se limitan a Brightspace UADE. Se comprueba el destino inicial y el final antes de devolver o procesar contenido. El navegador puede cargar recursos externos de una página y seguir redirecciones antes de que el conector rechace un destino inesperado; no es un aislamiento de red.
Mis cursos puede mostrar solo una selección de tus inscripciones. El listado
inicial de Contenido combina módulos visibles y temas del módulo seleccionado;
entrar a cada carpeta permite consultar sus materiales. El MCP indica listas
parciales mediante completo, aviso y cursor. Una actualización de Brightspace
puede requerir adaptar los selectores.
Los documentos admiten hasta 25 MiB y 10.000 caracteres por fragmento. PDF/DOCX/PPTX se procesan en un subproceso con límites y se borran los archivos temporales. No hay OCR ni extracción de audio, video, imágenes o diagramas; no se ejecutan archivos de código, ZIP ni RAR. Una lectura parcial del visor se identifica.
Desarrollo
.venv/bin/python -m pip install --require-hashes -r requirements-dev.lock
.venv/bin/python -m pytest -q
.venv/bin/python -m build
.venv/bin/python scripts/package.pyLas pruebas usan Chromium real sobre páginas sintéticas, sin iniciar sesión.
El paquete de fuentes no contiene entorno virtual, perfiles ni documentos
personales. Después de modificar el código instalado, ejecutá nuevamente
scripts/install.py para actualizar el paquete de la instalación.
Verificación y límites · Licencia MIT. Proyecto independiente, sin afiliación con UADE ni D2L. Se ofrece tal cual, sin garantías; verificá fechas y entregas directamente en la plataforma.
Available Tools
8 toolsestado_conexionARead-only
Comprueba si el navegador está abierto y si Brightspace requiere autenticación.
Inputs: no named parameters. Returns: object
iniciar_sesionA
Abre un navegador dedicado para ingreso y MFA en modo visible. En modo sin ventana, usar login desde una terminal gráfica con el cliente MCP cerrado. Devuelve pronto; consultar estado_conexion después.
Inputs: no named parameters. Returns: object
leer_anunciosBRead-only
Lee noticias visibles de la materia. Abrirlas puede marcarlas como leídas.
Inputs: materia_id (required), cursor, limite. Returns: object
leer_documentoARead-only
Lee páginas HTML y PDF/DOCX/PPTX (máximo 25 MiB) por fragmentos. No abre cuestionarios ni asignaciones como documentos. Sin OCR; el visor puede ser parcial.
Inputs: archivo_id (required), cursor, limite_caracteres. Returns: object
leer_tareaARead-only
Lee consigna, vencimiento, estado y materiales de un ID obtenido con listar_tareas.
Inputs: tarea_id (required). Returns: object
listar_archivosCRead-only
Lista unidades, módulos y temas de Contenido. carpeta_id proviene de un listado anterior. Puede actualizar el progreso de lectura.
Inputs: materia_id (required), cursor, limite, carpeta_id. Returns: object
listar_materiasCRead-only
Lista cursos visibles de Mis cursos con IDs opacos. Puede haber filtros; no garantiza todas las inscripciones.
Inputs: cursor, limite. Returns: object
listar_tareasARead-only
Lista actividades de una materia con estado y vencimiento original; usa leer_tarea para la consigna.
Inputs: materia_id (required), cursor, limite. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Each tool targets a clearly distinct action or resource: connection status, login, course listing, task listing/reading, announcements, content listing, and document reading. The list/detail pairs (listar_tareas/leer_tarea, listar_archivos/leer_documento) have explicit boundaries, so an agent can select the right tool without ambiguity.
Most tools follow a consistent Spanish snake_case verb_noun pattern (listar_materias, leer_tarea, iniciar_sesion). The only notable deviation is estado_conexion, which is noun-based rather than verb-based, but it remains readable and predictable within the set.
Eight tools are well-scoped for a read-only Brightspace browsing client. Each tool earns its place by covering a distinct step in authentication, course discovery, and content reading without redundant surface area.
The set covers authentication, course listing, assignments, announcements, and content/document reading, but leaves notable LMS gaps such as grades, assignment submission, discussions, quizzes, and calendar workflows. Agents will encounter dead ends for common Brightspace tasks beyond read-only content browsing.
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.
Read-only access to a student's recorded classes: transcripts, notes, slides and concept map.
Read-only access to Epivo's live course catalogue for AI agents.
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables read-only access to NYU Brightspace for deadlines, assignments, grades, announcements, and course content.16MIT
- AlicenseNot gradedqualityCmaintenanceLets AI assistants read a student's Canvas LMS/Moodle courses, deadlines, announcements, grades and course files using their normal browser login instead of an access token. It is read-only and keeps all session data and downloads on the user's own machine.36 npm1MIT
- AlicenseAqualityCmaintenanceEnables an MCP-compatible assistant to log in with UNC single sign-on and explore the FCEFyN virtual classroom, listing enrolled courses, retrieving course indexes and materials, and reading or searching pages, activities, and PDFs. It works read-only with the user's own credentials, without tokens, admin permissions, or downloading entire courses.4MIT
- FlicenseNot gradedqualityBmaintenanceEnables agents to query course information, announcements, assignments, and deadlines, and to download attachments, syllabus PDFs, and lecture videos through a local browser connection. It can also prepare assignment submissions for review without uploading by default.2-