sigaa-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., "@sigaa-mcp show my current classes, grades, and upcoming assignments"
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.
sigaa-mcp
Cliente do SIGAA (Sistema Integrado de Gestão de Atividades Acadêmicas) orientado a agentes, construído sobre a interface web — as páginas HTML (HyperText Markup Language) que um navegador usa — e não sobre a API (Application Programming Interface) oficial mobile/OAuth. A ideia é ser conduzido por agentes de código (Claude, Codex, Antigravity, …), e futuramente exposto via MCP (Model Context Protocol).
Escopo: conectar e ler dados agora; escrever dados depois.
Situação
Início, mas já lendo dados reais. Prontos:
Login web via CAS → sessão web autenticada (
JSESSIONID) reusada nas requisições de página.Portal do discente (
discente.jsf): dados do aluno, turmas matriculadas (com horários decodificados), o feed de últimas atualizações por turma, próximas atividades (tarefas/avaliações), notícias institucionais e tópicos do fórum do curso.Histórico de turmas (
turmas.jsf, "Ver turmas anteriores"): todas as turmas, atuais e passadas, agrupadas por período.Turma virtual (
ava/index.jsf): abrir uma turma e ler quase tudo — Tópicos de Aula (com datas, conteúdo e materiais), participantes (docentes e discentes), notas do próprio aluno, frequência, tarefas, avaliações, notícias da turma, fóruns, referências, arquivos, questionários, enquetes e o plano de curso.Detalhes por item: texto completo de uma notícia (
fetchNewsDetail) e perfil de um participante (fetchParticipantProfile) — buscados individualmente pelo id do item.Download de arquivos e fotos: baixar qualquer material/arquivo pelo
fileId(downloadTurmaFile) e a foto de um participante pelopersonId(downloadParticipantPhoto).Servidor MCP: as funções acima expostas como ferramentas MCP por stdio (veja abaixo).
Ainda não feito: algumas seções da AVA (Conteúdo/Página web, Vídeos, Linha do Tempo) e escrita de dados. Veja docs/SITE.md para como o site funciona (stack, CAS, navegação por ViewState/POST do JSF, códigos de horário).
Related MCP server: UniMCP
Como o login funciona
Handshake padrão do CAS (Central Authentication Service) contra o servidor de autenticação da UFRN:
GETno formulário de login do CAS → lê os campos ocultoslteexecution.POSTcomusername/password/lt/execution→ recebe umticket=ST-….Segue o ticket até o SIGAA → o SIGAA valida e define o cookie de sessão
JSESSIONID.
O objeto SigaaSession então carrega esse cookie jar nas requisições seguintes.
Experimente
npm install
cp .env.example .env # preencha SIGAA_USERNAME / SIGAA_PASSWORD
npm run login # testa o login via CAS
npm run portal # busca e imprime o portal e o histórico de turmas em JSONAs credenciais são lidas apenas de variáveis de ambiente. Nunca faça commit do .env — ele está no gitignore.
Servidor MCP
Além da biblioteca, o pacote expõe um servidor MCP (Model Context Protocol) por stdio, para conectar em qualquer harness compatível (Claude Code, Claude Desktop, Codex, Cursor, Antigravity, opencode, Windsurf, Zed, …). O servidor lê as credenciais do ambiente e faz login automaticamente na primeira chamada.
Guia completo de instalação por harness:
docs/INSTALL.md.
Ferramentas: get_portal, get_all_classes, get_turma (arg
frontEndIdTurma), get_news_detail (frontEndIdTurma, newsId),
get_participant_profile (frontEndIdTurma, personId),
download_participant_photo (frontEndIdTurma, personId) e download_file
(frontEndIdTurma, fileId). Os detalhes de cada item são buscados
individualmente pelo id (news[].id, participants[].personId), sob demanda.
Depois de publicado no npm, basta npx -y sigaa-mcp como comando — sem clonar
nada. Para rodar a partir do clone (desenvolvimento ou antes de publicar),
gere o dist/ primeiro:
npm install && npm run buildClaude Code (via npm):
claude mcp add sigaa \
-e SIGAA_USERNAME=seu.login -e SIGAA_PASSWORD=sua-senha \
-- npx -y sigaa-mcpOu via JSON (Claude Desktop / Codex / outros que leem mcpServers):
{
"mcpServers": {
"sigaa": {
"command": "npx",
"args": ["-y", "sigaa-mcp"],
"env": {
"SIGAA_USERNAME": "seu.login",
"SIGAA_PASSWORD": "sua-senha"
}
}
}
}Variáveis opcionais: SIGAA_BASE_URL, SIGAA_AUTH_BASE_URL, SIGAA_DOWNLOAD_DIR
(onde download_file salva; padrão: diretório temporário).
Uso
import {
SigaaSession,
fetchPortal,
fetchAllClasses,
fetchTurmaFull,
downloadTurmaFile,
} from "sigaa-mcp";
const session = new SigaaSession();
await session.login(process.env.SIGAA_USERNAME!, process.env.SIGAA_PASSWORD!);
const portal = await fetchPortal(session);
console.log(portal.student.name, portal.enrolledClasses.length);
console.log(portal.activities); // próximas tarefas/avaliações
console.log(portal.news); // notícias institucionais
console.log(portal.forum); // tópicos do fórum do curso
const all = await fetchAllClasses(session); // atuais + passadas, por período
// Lê tudo de uma turma: tópicos, participantes, notas, frequência, tarefas,
// avaliações, notícias, fóruns, referências, arquivos, questionários, enquetes
// e plano de curso.
const turma = portal.enrolledClasses.find((c) => c.frontEndIdTurma);
if (turma?.frontEndIdTurma) {
const full = await fetchTurmaFull(session, turma.frontEndIdTurma);
console.log(full.header, full.participants.length, full.grades, full.attendance);
// Baixar um arquivo da turma (material de tópico ou da aba Arquivos).
const file = full.files[0];
if (file) {
const { filename, bytes } = await downloadTurmaFile(session, turma.frontEndIdTurma, file.fileId);
console.log("baixado:", filename, bytes.length, "bytes");
}
}Os padrões apontam para a UFRN (sigaa.ufrn.br / autenticacao.ufrn.br); sobrescreva pelo construtor do SigaaSession ou pelas variáveis de ambiente SIGAA_BASE_URL / SIGAA_AUTH_BASE_URL.
Regras acadêmicas da UFRN
Para interpretar os dados (faltas, notas, prazos, situação de matrícula), há um
resumo navegável das regras de graduação da UFRN, com citação de artigos, em
docs/regras-ufrn/ — frequência/faltas, avaliação/notas,
matrícula, trancamento/suspensão e prazos/vínculo. Baseado no Regulamento dos
Cursos de Graduação (Resolução nº 016/2023-CONSEPE, texto vigente de março/2025).
Requisitos
Node.js ≥ 20 (usa o fetch nativo com Headers.getSetCookie()). Uma dependência de runtime: node-html-parser para fazer o parsing do HTML do SIGAA.
Available Tools
7 toolsdownload_fileBaixar arquivo da turmaA
Download a file published in a turma (a lesson-topic material or an Arquivos entry) by its fileId. Saves it locally and returns the path, filename, content type and size. fileIds come from get_turma (topics[].materials[].fileId or files[].fileId).
Inputs: fileId (required), frontEndIdTurma (required).
download_participant_photoBaixar foto de participanteA
Download a participant's profile photo by personId. Saves it locally and returns the path, filename, content type and size. Only works for participants who have a photo.
Inputs: personId (required), frontEndIdTurma (required).
get_all_classesHistórico de turmasB
All enrolled classes, current and past, grouped by period (Ver turmas anteriores).
Inputs: no named parameters.
get_news_detailDetalhe de notícia da turmaA
Full text of one class news item, by its id (from get_turma's news[].id).
Inputs: newsId (required), frontEndIdTurma (required).
get_participant_profilePerfil de participanteA
Extra profile detail (curso, matrícula, descrição, Lattes, …) for a participant, by personId (from get_turma's participants[].personId).
Inputs: personId (required), frontEndIdTurma (required).
get_portalPortal do discenteA
Student info plus enrolled classes (with decoded schedules), the per-class updates feed, upcoming activities (tasks/exams), institutional news, and course-forum topics. Each enrolled class has a frontEndIdTurma used by the other tools.
Inputs: no named parameters.
get_turmaTurma completaA
Everything readable in a turma's virtual classroom: lesson topics (with materials), participants, the student's grades, attendance, tasks, assessments, class news, forums, references, file list, questionnaires/polls and the course plan. Pass the frontEndIdTurma from get_portal.
Inputs: frontEndIdTurma (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Most tools have clearly distinct purposes: aggregate portal data, historical class listing, classroom detail, news detail, participant profile, photo download, and file download. The main overlap is between get_portal and get_all_classes, since both expose enrolled classes, though the descriptions distinguish current dashboard data from historical/grouped class lists.
All names use consistent snake_case with predictable verb_noun or verb_object patterns such as get_portal, get_turma, get_news_detail, and download_file. The single get_all_classes deviation still follows the same readable convention.
Seven tools are well scoped for a read-oriented student portal integration. Each tool covers a meaningful slice of the workflow, and there is no obvious filler tool.
The surface covers the core read workflows: portal overview, class history, classroom details, news, participant profiles/photos, and file downloads. Minor gaps remain for deeper forum thread contents or richer activity detail, but the main lifecycle is covered for a read-only server.
Maintenance
Related MCP Connectors
Stealth web automation for AI agents. Login, signup, navigate, screenshot.
Stealth web automation for AI agents. Login, signup, navigate, screenshot.
Hosted browser for agents: open pages, search the web, extract data, read PDFs and take screenshots.
Web data for agents. Extract web pages, crawl websites, discover URLs, and search the web.
Related MCP Servers
- FlicenseAqualityCmaintenanceEnables deep access to UFRPE's SIGAA system, providing tools for login, retrieving raw HTML, making custom requests, downloading files, and accessing parsed academic data such as grades, classes, and curricula.12-
- 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
- AlicenseNot gradedqualityBmaintenanceConnects AI agents to Argentine university systems so they can browse Moodle virtual classrooms, read course materials and forum discussions, search across courses, and consult SIU Guaraní academic records such as grades, enrollments, and exam boards. With user confirmation it can also post in forums, submit assignments, answer choices, and send messages.MIT
- AlicenseNot gradedqualityBmaintenanceEnables querying the IFSC SIGAA student portal to retrieve a student's profile, classes, schedules, grades, attendance, assignments, exams, news, and academic documents, and also provides access to the IFSC Moodle for courses, materials, deadlines, grades, forums, and messaging. Includes session management with browser-based login or pasted cookie, and confirmation-gated submission of assignments and forms.MIT