Expeditto
OfficialThis MCP server helps a docente prepare the SUAP IFMA RIT end-to-end, from diagnostics and login to collecting evidence, resolving pendências, generating attachments/texts, and saving a draft without ever submitting it.
Start and track RIT preparation by semester, including background login and collection tasks.
Diagnose setup, SUAP session, AI app connections, email, and check/install updates.
List semesters, collect SUAP receipts, summarize the semester acervo, and manage input-folder files.
Find and register atas from email or Gmail backup.
Resolve pendências, detail them, and complete Lattes publication metadata via public bases.
Generate per-topic attachment PDFs, automatic Relato drafts, and “Alterações de Atividades.”
Read topic context, save edited Relato HTML, preview what will be filled in SUAP, and save as RIT draft only after explicit confirmation.
Open approved SUAP/PDF/DOI links in the browser and provide an assistant guide.
Provides Gmail integration for logging in and backing up semester meeting minutes (atas) via email through the gmail-login and gmail-atas commands.
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., "@Expeditto colete os comprovantes de 2025.1 e prepare o rascunho do RIT"
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.
Expeditto
Seu segundo expediente, resolvido. Assistente da burocracia docente. Hoje ele prepara o Relatório Individual de Trabalho (RIT) do SUAP IFMA: garimpa seus comprovantes, organiza por semestre e tópico, redige os relatos e deixa o rascunho salvo no SUAP para você conferir e entregar.
Ferramenta independente e não oficial. Roda no seu computador, com a sua sessão do SUAP, e nunca entrega o relatório por você. Licença AGPL-3.0.
Funciona pelo terminal (expeditto) e dentro do seu assistente de IA (servidor MCP para Claude Desktop, Claude Code, Codex e Gemini/Antigravity CLI).
Descoberta e visão do produto:
docs/discovery.mdRotas e telas do SUAP mapeadas:
docs/mapa-suap-ifma.mdDecisões e regras de negócio:
docs/decisoes.md
Instalação
Windows (PowerShell):
irm https://expeditto.fabitz.com.br/install.ps1 | iexmacOS e Linux:
curl -LsSf https://expeditto.fabitz.com.br/install.sh | shO instalador coloca o uv se faltar, instala o Expeditto e abre o assistente
expeditto instalar: navegador para o login, pasta de dados, conexão com os apps de IA (Claude Desktop, Claude Code,
Codex, Gemini CLI, Antigravity), login no SUAP e diagnóstico. Depois: expeditto atualizar e expeditto desinstalar
(tira o Expeditto dos apps; os dados só saem se você pedir).
Related MCP server: Apps Script + Sheets + Shopee CSV MCP
Interface visual (terminal)
uv sync
uv run expeditto # tela cheia: semestres, preparar RIT, pendências, anexos, relatos, salvar
uv run expeditto --semestre 2025.2 --alto-contraste
uv run expeditto doctor # diagnóstico: navegador, sessão, apps de IA conectadosO despertador laranja é o mascote do Expeditto (pixel art em docs/marca/). Mouse e teclado funcionam em
todas as telas; em janelas pequenas o mascote dá lugar ao conteúdo.
Uso (comandos)
uv run expeditto login # janela do SUAP para login (CAPTCHA/Gov.br); fecha sozinha
uv run expeditto semestres # estado do PIT/RIT por semestre + links
uv run expeditto coletar 2025.1 # coleta, classifica e baixa comprovantes
uv run expeditto status 2025.1 # resumo por tópico + pendências
uv run expeditto montar 2025.1 # 1 PDF por tópico (capa + índice), ≤ 10 MB
uv run expeditto textos 2025.1 # rascunhos dos Relatos (HTML)
uv run expeditto entrada 2025.1 # onde colocar comprovantes próprios
uv run expeditto preencher 2025.1 [--salvar] # prévia; com --salvar grava rascunho (nunca entrega)
uv run expeditto gmail-login / gmail-atas 2025.1 # backup de atas por e-mail
uv run expeditto mcp # servidor MCP (ver docs/integracao-hosts.md)
uv run expeditto logout # apaga a sessão do keyring e o perfil do navegadorO acervo fica em ~/expeditto/ (ou em EXPEDITTO_HOME):
perfil.json # contexto do docente (allowlist, sem dados sensíveis)
_cache/ # downloads e textos de portarias, por chave estável
2025.1/manifest.json # evidências, tópicos, motivos e pendências
2025.1/01-apoio-ensino/*.pdf # uma pasta por tópico do RIT (cópia física)
...Estado
O protótipo 1 foi validado com dados reais (2025.1): 72 evidências nos 7 tópicos, 65 delas comprovadas por 54 PDFs distintos, e 1 pendência legítima. Os números estão em docs/decisoes.md §10. Próximo passo: servidor MCP, Gmail, junção dos PDFs, textos e "Salvar" (protótipo 2).
Garantias
Somente leitura no protótipo 1. Nada é salvo nem enviado no SUAP.
Allowlist de rotas (
client.py): só páginas e documentos do próprio usuário./admin/,entregar_relatorioeenviar_planoficam bloqueados.Minimização de dados: o perfil lê só os campos da allowlist (D26). CPF, dados bancários, endereço etc. nem são extraídos.
Sessão no keyring do SO, válida por cerca de 90 min. A senha nunca passa pela ferramenta.
Testes
uv run pytestAvailable Tools
26 toolsaguardar_tarefaARead-only
Acompanha uma tarefa em segundo plano (login, coleta). Volta em até segundos (padrão 10, máx. 25) ou
antes, quando muda de etapa. Mostre a linha progresso ao docente a cada chamada e chame de novo.
Inputs: tarefa_id (required), segundos.
atualizar_expedittoADestructiveIdempotent
Atualiza o Expeditto para a versão mais nova. Só chame com confirmado=true se o docente pedir. Depois, o app de IA precisa ser reiniciado (ou o Expeditto reconectado) para usar a versão nova.
Inputs: confirmado.
buscar_atas_gmailARead-only
BACKUP para hosts SEM integração de e-mail: busca atas no Gmail das contas autorizadas
na CLI (expeditto gmail-login). Devolve candidatas numeradas; o docente escolhe quais registrar.
Inputs: semestre (required).
classificar_entradaCIdempotent
Move um arquivo solto da pasta de entrada para o tópico informado pelo docente.
Inputs: topico (required), arquivo (required), semestre (required).
coletar_semestreAIdempotent
Coleta os comprovantes do semestre (AAAA.P) no SUAP, em segundo plano (2 a 8 minutos).
Devolve tarefa_id: acompanhe com aguardar_tarefa, mostrando a barra ao docente.
Inputs: semestre (required).
completar_lattesAIdempotent
Busca data, tipo (artigo, capítulo, anais...), veículo e DOI das publicações do Lattes pendentes em bases públicas (Crossref, OpenAlex), para sugerir o semestre de cada uma. A coleta já faz isso; use em coletas antigas ou quando os itens vierem sem data.
Inputs: semestre (required).
contexto_topicoCRead-only
Fatos de um tópico para redigir o Relato. topico: apoio_ensino, programas_projetos_ensino, orientacao_alunos, reunioes, pesquisa, extensao, gestao.
Inputs: topico (required), semestre (required).
detalhar_pendenciaARead-only
Explica UMA pendência ao docente: o que é, por que importa, o efeito de cada opção, a sugestão e os links para conferir (SUAP, comprovante, DOI). Use quando ele tiver dúvida sobre um item.
Inputs: numero (required), semestre (required).
diagnosticoARead-only
Verifica se o Expeditto está pronto: versão, pasta de dados, navegador, sessão no SUAP, perfil,
apps de IA conectados e e-mail. Cada item traz como_resolver quando há problema.
Inputs: verificar_suap.
gerar_alteracoesBIdempotent
Monta 'Alterações de Atividades' a partir das pendências justificadas pelo docente.
Inputs: semestre (required).
gerar_rascunhosBIdempotent
Gera rascunhos automáticos dos Relatos (não sobrescreve textos já revisados, salvo se pedido).
Inputs: semestre (required), sobrescrever.
guiaARead-only
Guia do Expeditto para você (assistente): fluxo, topicos, pendencias, relatos, lattes, regras.
Leia fluxo no começo de uma conversa sobre o RIT e o assunto específico quando precisar.
Inputs: assunto. Returns: result
listar_semestresBRead-only
Semestres com o estado do PIT/RIT e o link correspondente no SUAP.
Inputs: no named parameters. Returns: result
loginAIdempotent
Abre uma janela do SUAP para o docente fazer login (CAPTCHA/Gov.br); ela fecha sozinha.
Devolve tarefa_id: acompanhe com aguardar_tarefa e avise o docente para olhar a janela.
Inputs: no named parameters.
montar_anexosBIdempotent
Gera o PDF de anexo de cada tópico (capa + índice + comprovantes, até 10 MB).
Inputs: semestre (required).
pasta_entradaCRead-only
Onde o docente coloca comprovantes próprios (PDF/JPG/PNG), uma subpasta por tópico (E8).
Inputs: semestre (required).
preparar_ritARead-only
PONTO DE PARTIDA para qualquer pedido sobre o RIT (Relatório Individual de Trabalho), o relatório do semestre ou os comprovantes do SUAP. Diz em que passo o semestre (AAAA.P) está e qual ferramenta chamar em seguida. Sem semestre, lista os RITs a preencher para o docente escolher.
Inputs: semestre, seguir_sem_decidir.
previa_preenchimentoBRead-only
O que será enviado ao formulário do RIT (textos e anexos) — mostre ao docente antes de salvar.
Inputs: semestre (required).
registrar_ataBIdempotent
Registra uma ata/convocação encontrada no e-mail (pela integração de e-mail do host).
data em dd/mm/aaaa ou aaaa-mm-dd. Envie o PDF anexo em base64 se tiver acesso a ele.
Inputs: data (required), assunto (required), semestre (required), remetente (required), +4 more.
registrar_atas_gmailBIdempotent
Registra as candidatas escolhidas pelo docente (números de buscar_atas_gmail), baixando o PDF anexo.
Inputs: numeros (required), semestre (required).
resolver_pendenciaAIdempotent
Registra a decisão DO DOCENTE sobre uma ou mais pendências (números vindos de preparar_rit/resumo_semestre).
decisao: manter | remover_item | justificar (exige justificativa ditada pelo docente) | ignorar.
Pendências 'lattes_sem_comprovante': se o docente tiver o comprovante, oriente-o a colocá-lo na
pasta de entrada (ver pasta_entrada) e marque 'manter'; se não entra no RIT, 'ignorar'.
Inputs: decisao (required), numeros (required), semestre (required), justificativa.
resumo_semestreCRead-only
Resumo do acervo do semestre: itens por tópico, pendências numeradas, anexos e textos.
Inputs: semestre (required).
salvar_no_suapADestructiveIdempotent
Grava textos e anexos no formulário do RIT como RASCUNHO ("Salvar"). Nunca entrega. Só chame com confirmado=true depois que o docente aprovar a prévia explicitamente.
Inputs: semestre (required), confirmado.
salvar_textoCIdempotent
Grava o Relato (HTML simples: p, ul, li, strong) de um tópico ou de 'alteracoes'.
Inputs: html (required), topico (required), semestre (required).
verificar_atualizacaoARead-only
Diz se há versão nova do Expeditto (consulta a última release; cache de um dia).
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 26 tools
Most tools have clearly distinct purposes (e.g. detalhar_pendencia vs resolver_pendencia, verificar_atualizacao vs atualizar_expeditto), and descriptions actively differentiate near-pairs. A few pairs risk confusion—salvar_texto vs salvar_no_suap, gerar_alteracoes vs gerar_rascunhos, coletar_semestre vs completar_lattes, registrar_ata vs registrar_atas_gmail—but the descriptions disambiguate them adequately.
The set overwhelmingly uses Portuguese snake_case verb_noun names (gerar_alteracoes, salvar_no_suap, listar_semestres, coletar_semestre, montar_anexos). Minor deviations are noun-only names (guia, diagnostico, login, pasta_entrada, resumo_semestre, contexto_topico), which are still readable and consistent in style.
26 tools is on the heavy side, but the domain (full RIT workflow spanning SUAP collection, Lattes completion, pendency resolution, text drafting, attachments, and Gmail backup) is genuinely broad and each tool appears to earn its place. Slightly over-scoped but defensible.
The surface covers the lifecycle well: preparation (preparar_rit), collection (coletar_semestre, completar_lattes), pendency decisions (resolver_pendencia), text (salvar_texto, gerar_rascunhos), attachments (montar_anexos), and submission (salvar_no_suap as draft). Minor gaps around deletion/editing of individual collected items, but agents can work around them.
Maintenance
Related MCP Connectors
Receipt ingestion, Gmail capture, expense analysis, and reviewed reports for AI-agent workflows.
Track expenses from receipt photos, then search, summarize and update them from your AI assistant.
Capture and organize receipts from your AI chat: totals, categories, ledgers.
Every AI tool you use knows your work and follows your rules, with a receipt for every action.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to navigate, search, and analyze academic materials organized in cycles, semesters, and modules via Google Drive.3-
- FlicenseNot gradedqualityCmaintenanceEnables AI assistants to read Shopee CSV reports from Google Drive, parse commission and click data, and refresh daily KPI reports in Google Sheets.-
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to pull teaching evidence from SIAKAD Pradita, such as class lists, lecture minutes, and signed student attendance, ready to be attached as BKD proof.MIT

Coletum MCP Serverofficial
AlicenseAqualityBmaintenanceEnables an AI assistant to read form structures and submissions from a Coletum account (read-only) and to produce Excel/CSV exports, Coletum-style or user-template PDFs, and photographic reports on request. It also stores preferences such as logo and company name and reports where each generated file was saved.13MIT